Apple App Store API

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
Try it live

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

View docs ↗

The newest App Store reviews of an app, with rating, title, text, date and app version

1 credit0 required · 4 optional
POST/apple-app-store/v1/reviews
idle
// 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.

Try every endpoint in the playground

Endpoints

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.

7 endpoints

reviews

1 cr

App Store reviews for one or more apps (by Apple id, an apps list, or an app name to search).

required
—
optional
apps, appleAppId, appName, countries, maxReviews, cursor

search

1 cr

Ranked App Store search results for a keyword in one storefront country.

required
query
optional
country, count

topCharts

1 cr

An App Store top chart (top free, top paid, top grossing, new) for a storefront country, opti…

required
—
optional
country, category, count, chart, device

listCategories

1 cr

The App Store genre list (id and name) that topCharts accepts.

required
—
optional
—

appDetails

1 cr

One App Store app's full profile by Apple id.

required
—
optional
appId, appleAppId, country

developerApps

1 cr

Every other App Store app published by the same developer as the given app.

required
—
optional
appId, appleAppId, country, count

similarApps

1 cr

Apple publishes no public 'similar apps' feed, so this returns the developer's other App Stor…

required
—
optional
appId, appleAppId, country, count

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 it works

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.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

02
Call
POST /apple-app-store/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01topCharts
POST/apple-app-store/v1/topCharts
{"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.

02appDetails
POST/apple-app-store/v1/appDetails
{"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+.

03reviews
POST/apple-app-store/v1/reviews
{"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.

04reviews
POST/apple-app-store/v1/reviews
{"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.

request
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}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "apple-app-store",
    "endpoint": "reviews",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
app_id vs bundle_idapp_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_countrating_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.
histogramStar 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, freeFollow the storefront country: Spotify in the US was 0.0 USD, free true. Ask another country for its own price and currency.
released, updatedISO 8601 in UTC: released 2011-07-14T11:22:37Z, updated 2026-11-20T07:17:17Z for Spotify.
installs, contains_ads, developer_emailnull: Apple does not publish them.
reviews[].app_versionThe 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_textlanguage 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_cursorCAPPED 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 rowsrank, 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 appDetails0 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.

Coverage

Apple App Store coverage, measured

Every number below comes from live calls on 2026-11-21.

Reviews

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.

Paging

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.

App details

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.

Top charts

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).

Limits

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.

Use cases

What people build with Apple App Store

The jobs this data is most often used for.

7

endpoints

1

credit per call

01

Monitor new App Store reviews of your app and competitors per country and app version.

02

Track rating histograms and rating counts over time.

03

Follow top free, paid and grossing charts per country and genre.

04

Research App Store search results for keywords (app store optimisation).

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.