{"uid":"cap_2DMOmALoik6QDzlKwLR7T","slug":"apple-app-store-reviews-fetcher-fdecce08","name":"Apple App Store Reviews Fetcher","description":"Apple App Store reviews — pull an app's user reviews by numeric product_id: title, text, rating, version, author & date, with paging & sort, as clean JSON.","url":"https://appstore.use.x402atlas.com/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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["product_id"],"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)"},"product_id":{"type":"string","pattern":"^[0-9]+$","maxLength":32,"description":"Numeric App Store app id (from /appstore/search)"}}}},"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"}}},"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_lC935i6KAYn4zRF7mcenH","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, returning title, text, rating, version, author, and date as clean JSON.","exampleAgentPrompt":"Can you pull the most recent user reviews for the Spotify iOS app (product ID 324684580) from the US App Store, starting on page 1?","exampleUseCases":null,"resultDescription":"A JSON object containing the product_id, query timestamp, pagination info (total pages, results count, reviews for current version), and an array of review objects each with id, title, text, numeric rating, author name and ID, review date, reviewed version, position, and helpfulness vote info.","failureModes":["Invalid or non-numeric product_id returns an error","App not found for given product_id returns empty or error response","Invalid country code may return no results or default to a fallback store","Invalid sort enum value returns a validation error","Page number beyond total page count returns empty reviews array","Payment not processed results in 402 response"],"whenToPreferThis":"Use this endpoint when you need the actual text and metadata of user-submitted App Store reviews for a specific iOS app — especially for sentiment analysis, competitive research, or user feedback monitoring. Prefer this over the product details endpoint when you need the full body of individual reviews rather than aggregate rating summaries. Pair with the App Store search endpoint to resolve an app name to its numeric product_id first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:16.190Z","isFirstParty":false}