{"uid":"cap_0dm2EzicItpGWqzTYQ1bi","slug":"app-store-listing-and-ratings-671d1e58","name":"App Store Listing and Ratings","description":"App Store listing data for any app on any storefront: current and all-time star ratings with review counts, version, release notes, size, price, content rating, genres and release dates. Includes a version-sentiment read comparing the current version's rating against its all-time average, which is how you spot a release that damaged an app. Look up by numeric App Store id or search by name.","url":"https://x402-filings.datalayer.workers.dev/v1/apps/lookup?utm_source=zero.xyz","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","properties":{"appId":{"type":"string","examples":["284882215"],"description":"Numeric App Store id. Either appId or search is required."},"limit":{"type":"integer","examples":[10],"description":"Max apps when searching, 1-25. Default 10."},"search":{"type":"string","examples":["duolingo"],"description":"App name to search for instead of an id."},"country":{"type":"string","examples":["us"],"description":"Two-letter storefront. Default us."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oZmDkc6uvrKjXUCL5rFC5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves App Store metadata for any app including star ratings, review counts, version, price, size, genres, and a version-sentiment comparison between current and all-time ratings.","exampleAgentPrompt":"Can you look up the App Store listing for Duolingo on the US storefront and tell me its current star rating, all-time rating, latest version, and whether the new version hurt or improved its reception?","exampleUseCases":[{"title":"Spot a damaging app update","prompt":"Check the App Store listing for Instagram — I want to know if the current version's rating is significantly lower than its all-time average, which would tell me a recent release upset users."},{"title":"Competitive app research","prompt":"Search the US App Store for 'Calm' and give me its current price, genres, content rating, and how many reviews it has."},{"title":"App version release notes lookup","prompt":"Pull up the App Store page for app ID 284882215 and show me the latest version number and its release notes."}],"resultDescription":"Returns structured App Store data including current star rating, all-time star rating, review count, app version, release notes, file size, price, content rating, genre tags, and release dates. Also includes a version-sentiment indicator comparing the current version's rating to the all-time average so you can tell whether a recent update helped or hurt the app's reputation.","failureModes":["App ID not found: returns empty or error if numeric ID doesn't match any app","Search returns no results: if the app name search yields nothing, the result set will be empty","Country code invalid: unrecognized storefront code may default to US or return an error","Limit out of range: limit values outside 1-25 may be rejected or clamped","Rate limiting or payment failure: x402 payment not processed results in 402 response"],"whenToPreferThis":"Use this endpoint when you need rich App Store metadata beyond what a simple search returns — especially when you want the version-sentiment delta to detect whether a recent release damaged an app's reputation. Prefer this over scraping the App Store or using iTunes Search API directly when you need structured, normalized output with the current-vs-all-time rating comparison built in. Ideal for competitive intelligence, app monitoring, and release quality assessment workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:36:45.678Z","isFirstParty":false,"canonicalSlug":"app-store-listing-and-ratings-671d1e58"}