Apple App Store
Apple App Store reviews with paging, app details with the star histogram, search, top charts, categories and a developer's other apps, per storefront country, as JSON.
/apple-app-store/v1/reviews1 creditApp Store reviews for one or more apps (by Apple id, an `apps` list, or an app name to search): rating, title, text, date, reviewer, app version and developer reply, per storefront country; `cursor` pages further (next_page_cursor).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| apps | optional | — | Apps to fetch reviews for: an array of objects with any of {name, apple/appleAppId, play/googlePlayPackage}, or plain name strings. Alternative to the single-app id params. |
| appleAppId | optional | — | Apple numeric app id (single-app shortcut). |
| appName | optional | — | App name to search per store when ids aren't supplied. |
| countries | optional | — | App Store storefront country codes (2-letter, lowercase), e.g. ['us','gb']; 'all' for the aggregate set. Omit for the default storefront. |
| maxReviews = 1000 | optional | 1–100000 | Maximum reviews to collect per app/store (clamped to 100000). |
| cursor | optional | — | Apple only: next_page_cursor from the previous response, to get the NEXT page of this app's Apple reviews (up to maxReviews, at most 500 per country per call). Send it with the same app, countries and sort as the first call and stores ['apple']. results[].next_page_cursor is null when Apple has no more. |
/apple-app-store/v1/search1 creditRanked App Store search results for a keyword in one storefront country.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | App search keyword (name or term). |
| country = us | optional | — | Storefront country code (2-letter, lowercase), e.g. 'us'. |
| count = 50 | optional | 1– | Maximum number of apps to return. |
/apple-app-store/v1/topCharts1 creditAn App Store top chart (top free, top paid, top grossing, new) for a storefront country, optionally one genre, iPhone or iPad.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| chart = topFree | optional | topFree · topPaid · topGrossing · newFree · newPaid · new | Which Apple chart: topFree, topPaid, topGrossing, newFree, newPaid or new. |
| category | optional | — | Apple genre id, e.g. 6014 = Games (listCategories returns every id). |
| device = iphone | optional | iphone · ipad | Apple-only: chart device variant (iPad has fewer chart feeds). |
| country = us | optional | — | Storefront country code (2-letter, lowercase), e.g. 'us'. |
| count = 50 | optional | 1– | Maximum number of apps to return. |
/apple-app-store/v1/listCategories1 creditThe App Store genre list (id and name) that topCharts accepts.
Try in playground →/apple-app-store/v1/appDetails1 creditOne App Store app's full profile by Apple id: name, developer, price, rating and rating count with the star histogram, genres, version, release notes, size, screenshots and more, for a storefront country.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| appId | optional | — | Apple's numeric app id, the number in apps.apple.com/.../id<number> (e.g. 324684580 = Spotify). |
| country = us | optional | — | Storefront country code (2-letter, lowercase), e.g. 'us'. |
/apple-app-store/v1/developerApps1 creditEvery other App Store app published by the same developer as the given app.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| appId | optional | — | Apple's numeric app id, the number in apps.apple.com/.../id<number> (e.g. 324684580 = Spotify). |
| country = us | optional | — | Storefront country code (2-letter, lowercase), e.g. 'us'. |
| count = 50 | optional | 1– | Maximum number of apps to return. |
/apple-app-store/v1/similarApps1 creditApple publishes no public 'similar apps' feed, so this returns the developer's other App Store apps (same as developerApps), stated in the response.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| appId | optional | — | Apple's numeric app id, the number in apps.apple.com/.../id<number> (e.g. 324684580 = Spotify). |
| country = us | optional | — | Storefront country code (2-letter, lowercase), e.g. 'us'. |
| count = 50 | optional | 1– | Maximum number of apps to return. |
curl -X POST https://api.reefapi.com/apple-app-store/v1/reviews \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"apps":[{"name":"WhatsApp","apple":"310633997"}],"countries":["us"],"maxReviews":100}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.