Skip to main content
POST /v1/data/app-store/reviews/run Pricing: $0.002 per review ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
App Store app URLs (https://apps.apple.com/us/app/…/id324684580), numeric app IDs (324684580) or bundle IDs (com.spotify.client). One or more.
string
default:"us"
App Store country whose reviews to read, e.g. United States. Defaults to United States.175 allowed values, for example af (Afghanistan), al (Albania), dz (Algeria), ao (Angola), ai (Anguilla), ag (Antigua and Barbuda), ar (Argentina), am (Armenia), au (Australia), at (Austria). Fetch the full list with GET /v1/data/app-store/reviews?expand=options.
integer
default:"100"
How many reviews to return in total. Defaults to 100; use 0 for all.
string
default:"newest"
Sort By to use. Newest first by default.Allowed values: newest (Newest first), helpful (Most helpful (App Store default)), favorable (Most favorable (5 stars first)), critical (Most critical (1 star first)).
string[]
Only return reviews with these star ratings. Leave empty for all ratings.Allowed values: 1 (1 star), 2 (2 stars), 3 (3 stars), 4 (4 stars), 5 (5 stars).
date
Only reviews posted on or after this date (YYYY-MM-DD).

Example

Response fields

Each row in data is one review, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For app metadata use app-store/apps; for Android reviews use google/play/reviews.