ECOMMERCEDEVELOPER TOOLS API MCP READY

Apple App Store Reviews API

Apple App Store Reviews API. Fetch iOS and macOS app reviews on demand as structured JSON: ratings, titles, text, dates, versions, author, and helpfulness across 50+ country stores. Sort by most recent, most helpful, favorable, or critical. Built for ASO, sentiment, and AI agent workflows.

MEDIAN LAGon demand
PARAMETERS9
TOTAL USERS225
MONTHLY ACTIVE78
TOTAL RUNS2,176
RUNS SUCCEEDED99.1%
RATING5.0 (6)

Input parameters

PARAMETERTYPEREQDEFAULTDESCRIPTION
product_ids string[] no — Numeric Apple App Store product IDs (e.g. ['534220544', '363590051']).
app_name string no — Free-form Apple app name to look up automatically (e.g. 'netflix', 'spotify', 'todoist').
country enum no us Two-letter Apple country store code (e.g. 'us', 'gb', 'jp').
sort enum no mostrecent Order reviews by recency, helpfulness votes, or rating polarity.
max_reviews integer no 100 Hard cap on reviews returned per product ID.
start_page integer no 1 Page number to start paginating from (1-based).
include_macos boolean no True Set false to skip macOS apps entirely (no reviews pushed, no charges incurred for any macOS product_id).
normalize_dates boolean no True Emit a review_date_iso field alongside the locale-formatted review_date (e.g. '2021-06-02' alongside 'Jun 02, 2021').
parse_helpfulness boolean no True Extract integer helpful_count and total_helpful_count fields from the prose 'X out of Y customers found this review helpful' string.

Worked examples

Basic — the required input, with the schema's own example values
{
  "product_ids": [
    "534220544"
  ],
  "app_name": "example"
}

Coverage

52
country store — us gb ca au nz +47

Tasks

Saved runs with the inputs already filled in — each one a standalone page and a working configuration example.

Request a task →

Code

curl

curl -X POST "https://api.apify.com/v2/acts/johnvc~apple-app-store-reviews-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_ids": ["534220544"], "app_name": "example"}'

Python

from apify_client import ApifyClient

client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/apple-app-store-reviews-api").call(
    run_input={'product_ids': ['534220544'], 'app_name': 'example'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)