{"uid":"cap_EgA89ejF5-1RQTDuY8flw","slug":"apple-app-store-reviews-by-product-id-path-variant-7d962003","name":"Apple App Store Reviews by Product ID (Path Variant)","description":"**Apple App Store Search & Reviews** on x402 Atlas — pay-per-call over the [x402 protocol](https://x402.org).\n\nPaid routes are billed per call in USDC on Base, Polygon, or Arbitrum, starting at $0.005; each operation states its exact price below. Request a route with no payment to receive the `402` challenge, then repeat it with an `X-PAYMENT` header — an x402 client (`x402-fetch` / `x402-axios`) performs that exchange for you.\n\nFull onboarding, quickstart, and the other APIs: https://use.x402atlas.com/docs","url":"https://appstore.use.x402atlas.com/v2/product/%7Bproduct_id%7D/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":{"type":"json","example":{"info":{"results_count":500,"total_page_count":10},"reviews":[{"id":"7417861364","text":"Accurate and hilarious.","title":"Best weather app","author":{"name":"rainlover"},"rating":5,"review_date":"2026-07-01","reviewed_version":"5.9.0"}],"product_id":"1069513131","queried_at":"2026-07-11T12:00:00Z"}},"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_n3YmtmuD6ib4JwyQl0HCO","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 its numeric App Store product ID embedded in the URL path, returning titles, text, ratings, and version info.","exampleAgentPrompt":"Pull the most recent App Store reviews for the app with ID 1069513131 from the US store, starting on page 1.","exampleUseCases":[{"title":"Competitor app sentiment analysis","prompt":"Get me the most critical App Store reviews for the app with ID 535886823 from the US store so I can see what users hate about it."},{"title":"Monitor own app feedback","prompt":"Fetch the latest user reviews for our app, App Store ID 1234567890, sorted by most recent — I want to see what customers are saying this week."},{"title":"Localized review research","prompt":"Pull App Store reviews for app ID 310633997 in the UK store, sorted by most helpful, so I can understand what British users think of it."}],"resultDescription":"A JSON object containing a list of user reviews (each with ID, title, text body, star rating, author name, review date, and app version reviewed), along with pagination metadata (total results count, total page count) and the queried product ID and timestamp. If no reviews are found, a note field provides a hint.","failureModes":["Invalid or non-numeric product_id returns an empty reviews array with a note field rather than an error","Non-existent product_id may return empty results without a 404","Payment not provided returns HTTP 402 challenge requiring X-PAYMENT header","Invalid sort enum value may cause a validation error","Country code not supported may return results defaulting to US store","Rate limiting or network issues may cause intermittent failures"],"whenToPreferThis":"Use this endpoint when you already have a numeric App Store product ID (e.g. obtained from the search endpoint) and want to retrieve user reviews via a clean URL path structure. Prefer this path-variant over query-param alternatives when your HTTP client or routing layer makes path parameters more convenient. Choose the sort parameter to target specific review types: mostrecent for monitoring, mosthelpful for summarization, mostfavorable/mostcritical for sentiment analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:22.484Z","isFirstParty":false}