{"uid":"cap_PMvU2fcTxRiT_AsGGgwLZ","slug":"apple-app-store-reviews-by-product-id-path-variant-09be914f","name":"Apple App Store Reviews by Product ID (Path Variant)","description":"Apple App Store reviews (path variant) — an app's user reviews by product_id in the URL: title, text, rating, version, author & date, with paging & sort, as clean JSON.","url":"https://appstore.use.x402atlas.com/v2/product/:product_id/reviews","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","pattern":"^[0-9]+$","maxLength":32,"description":"Numeric App Store app id (from /appstore/search)"}}},"queryParams":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"description":"Optional page number"},"sort":{"enum":["mostrecent","mosthelpful","mostfavorable","mostcritical"],"type":"string","default":"mostrecent","description":"Optional order: mostrecent (default), mosthelpful, mostfavorable, mostcritical"},"country":{"type":"string","maxLength":2,"description":"Optional two-letter store country (e.g. us, gb)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["product_id","queried_at","reviews"],"properties":{"info":{"type":"object","properties":{"results_count":{"type":"integer"},"total_page_count":{"type":"integer"},"reviews_for_current_version":{"type":"integer"}}},"note":{"type":"string","description":"Present only when no reviews matched: a hint that product_id must be a numeric App Store id. The paid lookup still ran."},"reviews":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"title":{"type":"string"},"author":{"type":"object","properties":{"name":{"type":"string"},"author_id":{"type":"string"}}},"rating":{"type":"number"},"position":{"type":"integer"},"review_date":{"type":"string"},"reviewed_version":{"type":"string"},"helpfulness_vote_information":{"type":"string"}}}},"product_id":{"type":"string"},"queried_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kCfEf20OWN9iGu7Z9rG0D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches paginated user reviews for an iOS app by numeric product_id in the URL path, returning title, text, rating, version, author, and date as clean JSON.","exampleAgentPrompt":"Pull the most recent App Store user reviews for the app with ID 284882215 — grab page 1 sorted by mostrecent from the US store and give me the title, rating, and review text for each.","exampleUseCases":[{"title":"Sentiment analysis of app feedback","prompt":"Get me the latest 10 reviews for the app with App Store ID 544007664, sorted by mostrecent from the US store, so I can run sentiment analysis on what users think about the newest version."},{"title":"Monitoring competitor app reviews","prompt":"Fetch the most critical App Store reviews for app ID 310633997 — sorted by mostcritical — so I can see what pain points users are complaining about and compare them to our own app."},{"title":"App review digest for product team","prompt":"Pull the most helpful user reviews for app ID 389801252 from the UK store, sorted by mosthelpful, starting at page 1, and summarize the top themes and star ratings for our weekly product meeting."}],"resultDescription":"Returns a JSON object containing the product_id, query timestamp, and an array of reviews — each with id, title, text, rating (numeric), author name and ID, review date, reviewed app version, position, and helpfulness vote info. Also includes pagination metadata (total_page_count, results_count, reviews_for_current_version). A note field appears when no reviews matched.","failureModes":["Non-numeric or invalid product_id returns no reviews with a note hint rather than an error","App ID that does not exist on the App Store returns an empty reviews array","Requesting a page beyond total_page_count returns an empty or minimal response","Invalid country code may fall back to a default store or return no results","Rate limiting or payment failure may interrupt the x402 pay-per-call flow"],"whenToPreferThis":"Choose this endpoint when you need reviews for a specific iOS app by its numeric App Store ID and want clean, structured JSON with paging and sort control. The path-based product_id variant is useful when constructing URLs programmatically. Prefer it over scraping App Store pages directly, and use the companion search endpoint first if you need to resolve an app name to its numeric ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:33:48.449Z","isFirstParty":false}