Apple App Store reviews, ratings, app details and top charts as JSON, per storefront country
The Apple App Store API returns App Store reviews, app details, top charts, search results, categories and a developer's other apps as JSON, for any storefront country, with no Apple account and no key.
- endpoints
- 7
- credit per call
- 1
≈ 1 credit per call≈ $1/1,000 calls1,000 free credits, no card
7 active endpoints. Every call is 1 credit.
- POST/apple-app-store/v1/reviews1 credit
- POST/apple-app-store/v1/search1 credit
- POST/apple-app-store/v1/topCharts1 credit
- POST/apple-app-store/v1/listCategories1 credit
- POST/apple-app-store/v1/appDetails1 credit
- POST/apple-app-store/v1/developerApps1 credit
- POST/apple-app-store/v1/similarApps1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Apple App Store API
4 of 7 endpoints, ready to run
The newest App Store reviews of an app, with rating, title, text, date and app version
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Apple App Store endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Apple App Store endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Apple App Store API works
Apple App Store is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a top chart to every recent review of an app
Read the chart, open the app's profile, then page through its reviews with the cursor.
{"chart": "topFree", "country": "us"}On 2026-11-21 the US top free chart returned 100 apps with rank, Apple id, name, developer, price and category: 1 TikTok Pro - Events, 2 Muse from Meta, 3 Vinted, 4 ChatGPT, 5 Claude by Anthropic.
{"appId": "324684580", "country": "us"}Spotify on 2026-11-21: average rating 4.77 from 43,219,915 ratings, histogram 37,878,617 five-star to 969,185 one-star, version 9.2.2 updated 2026-11-20, 331,561,984 bytes, iOS 16.1 or later, 61 languages, 8 screenshots, rated 12+.
{"appleAppId": "324684580", "countries": ["us"], "maxReviews": 500}The 500 newest US reviews, newest first, each with rating, title, text, date, app version and reviewer name, plus next_page_cursor.
{"appleAppId": "324684580", "countries": ["us"], "maxReviews": 500, "cursor": "<next_page_cursor>"}The next 500, continuing where the first page stopped. Old calls to POST /app-store/v1/<action> keep working unchanged; the call for the Apple App Store is POST /apple-app-store/v1/<action>.
A dated set of an app's newest App Store reviews by country and version, next to its rating histogram and chart position.
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": { … },
"meta": {
"api": "apple-app-store",
"endpoint": "reviews",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What an App Store field actually contains
Fields that read differently from how they look. Each row was measured on live App Store data on 2026-11-21: appDetails and 500 United States reviews for Spotify (Apple id 324684580), and the US top free chart.
| Field | What it holds |
|---|---|
| app_id vs bundle_id | app_id is Apple's number, the digits after id in the apps.apple.com link (324684580 = Spotify). bundle_id is the developer's identifier (com.spotify.client). Every action takes the number. |
| rating_count, review_count | rating_count is everyone who gave stars (43,219,915 for Spotify in the US). Apple publishes no separate count of written reviews, so review_count is null. |
| histogram | Star counts with keys "5" to "1" plus "total": Spotify 37,878,617 / 3,035,403 / 968,653 / 385,605 / 969,185, total 43,237,463. The total is not exactly rating_count; Apple reports both. |
| price, currency, free | Follow the storefront country: Spotify in the US was 0.0 USD, free true. Ask another country for its own price and currency. |
| released, updated | ISO 8601 in UTC: released 2011-07-14T11:22:37Z, updated 2026-11-20T07:17:17Z for Spotify. |
| installs, contains_ads, developer_email | null: Apple does not publish them. |
| reviews[].app_version | The app version the reviewer used: on Spotify's 500 newest US reviews 9.2.0 on 362 and 9.2.2 on 138. |
| reviews[].language, reply_text | language was empty on 500 of 500 Spotify reviews (the storefront country is in country). reply_text holds the developer's reply when one exists; none of the 500 had one. |
| status, next_page_cursor | CAPPED means the call stopped at its 500-per-country limit, not that the app has no more reviews. Send next_page_cursor back as cursor with the same app and country for the next 500; it is null when Apple has no more. |
| chart and search rows | rank, Apple id, name, developer, price, currency, category, icon and link; avg_rating and rating_count are null (100 of 100 chart rows). Call appDetails for ratings. |
| meta.record_count on appDetails | 0 even when a full profile came back; read results[].status (COMPLETE for Spotify) instead. |
Every storefront country is its own catalogue: names, prices, currency and chart order follow the country you ask for.
Apple App Store coverage, measured
Every number below comes from live calls on 2026-11-21.
Spotify, United States: 500 of 500 reviews asked for, 500 unique review ids, newest first, written between 2026-11-19 09:25 and 2026-11-20 19:12 UTC. Rating, title, text, date, app version (9.2.0 on 362, 9.2.2 on 138) and reviewer name were filled on 500 of 500. Ratings: 294 five-star, 43 four, 50 three, 29 two, 84 one. 8.3 seconds.
At most 500 reviews per storefront country per call; the response says so (status CAPPED) and returns next_page_cursor to read the next 500. Reviews are billed per 50 returned.
Spotify: name, bundle id com.spotify.client, developer and website, average rating 4.77, 43,219,915 ratings, the 5 to 1 star histogram, price 0.0 USD, content rating 12+, version 9.2.2, release notes, released 2011-07-14, updated 2026-11-20, size, minimum iOS 16.1, 61 languages, 8 screenshots, categories Music and Entertainment.
US top free on 2026-11-21: 100 apps for a request of 200, because Apple's chart feed stops at about 100 per chart, country and genre (status PARTIAL, stated in the response). Charts: top free, top paid, top grossing, new free, new paid, new; iPhone or iPad; 26 genres from listCategories (6014 = Games).
Apple publishes no install counts and no written-review count: installs and review_count are null. Chart and search rows carry no rating (null on 100 of 100 chart rows); appDetails has it. The language field was empty and no developer reply was present on the 500 Spotify reviews. Apple has no public similar-apps list, so similarApps returns the developer's other apps. Google Play is a separate API: /google-play-api.
What people build with Apple App Store
The jobs this data is most often used for.
endpoints
credit per call
Monitor new App Store reviews of your app and competitors per country and app version.
Track rating histograms and rating counts over time.
Follow top free, paid and grossing charts per country and genre.
Research App Store search results for keywords (app store optimisation).
What Apple App Store data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/apple-app-store/v1/reviews",
headers={"x-api-key": REEF_KEY},
json={
"apps": [
{
"name": "WhatsApp",
"apple": "310633997"
}
],
"countries": [
"us"
],
"maxReviews": 100
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Apple App Store.
Is there an Apple App Store API?▾
Yes. The Apple App Store API on ReefAPI returns App Store reviews, app details with the star histogram, top charts, search results, categories and a developer's apps as JSON, for any storefront country, with no Apple account and no key. Call POST /apple-app-store/v1/<action>.
How do I get all reviews of an App Store app?▾
Call reviews with the Apple app id and a country, maxReviews up to 500. The response carries next_page_cursor; send it back as cursor for the next 500, until it is null. On 2026-11-21 Spotify's first US page returned 500 unique reviews from 2026-11-19 09:25 to 2026-11-20 19:12 UTC, newest first.
Which review fields come back?▾
Rating, title, text, date, app version, reviewer name and profile link, review id, the storefront country, and the developer's reply text and date when there is one. On 500 Spotify US reviews on 2026-11-21, rating, title, text, date, version and reviewer were filled on 500 of 500; no review had a developer reply and the language field was empty.
Can I read reviews from several countries?▾
Yes. countries takes a list of storefront codes, for example ["us", "gb", "de"]; each review carries its country. The 500-per-call limit applies per country.
What does appDetails return?▾
Name, bundle id, developer and website, average rating, rating count and the 5 to 1 star histogram, price and currency, content rating, description, release notes, version, release and update dates, size in bytes, minimum iOS version, languages, screenshots, icon, link and categories. Spotify on 2026-11-21: 4.77 from 43,219,915 ratings, version 9.2.2, 61 languages.
How many apps does a top chart return?▾
Up to about 100 per chart, country and genre: Apple's chart feed stops there. On 2026-11-21 a request for 200 apps in the US top free chart returned 100, with status PARTIAL and the reason in notes. Charts: topFree, topPaid, topGrossing, newFree, newPaid, new; device iphone or ipad; category one of 26 genre ids (6014 = Games).
Does it return install counts?▾
No. Apple publishes no install or download numbers, so installs is null. rating_count (43,219,915 for Spotify in the US) is the closest public measure of reach.
Does it cover Google Play?▾
No. This API reads the Apple App Store only. Google Play has its own API with exact install counts, data safety and reviews at /google-play-api.
Do old app-store calls still work?▾
Yes. Calls to POST /app-store/v1/<action> keep working unchanged, including both stores together. For the Apple App Store alone the call is now POST /apple-app-store/v1/<action>, without the stores parameter.
What is the Apple App Store API?▾
Apple App Store API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /apple-app-store/v1.
Is the Apple App Store API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Apple App Store calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Apple App Store login or account?▾
No login to Apple App Store is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Apple App Store data?▾
The page example is captured from a live reviews call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Apple App Store API use?▾
Apple App Store actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
19 Reputation & Reviews APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Apple App Store, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.