Skip to content
Gridlode
Docs · Reference

App Store Reviews

GET /v1/reviews/app-store1 credit / reviewcache 360 min

Written customer reviews of an Apple App Store app in any country storefront, most recent or most helpful first: rating, title, text, app version reviewed, date and helpful-vote counts, up to the 500 reviews (10 pages of 50) Apple's public review feed exposes per storefront. Reviewer names are pseudonymized unless you ask for them. Billed per review returned; apps without reviews, unknown apps and failed requests are free.

Query parameters

app_id
string · required
Numeric App Store id (570060128), 'id570060128' or an apps.apple.com app URL.
country
string
Two-letter App Store country (storefront) whose reviews to read, e.g. us, gb, de. Each storefront has its own reviews.
Default: "us"
sort
string
Review order.
Default: "most_recent"
Allowed: most_recent, most_helpful
limit
integer
Maximum reviews to return (1-500). Billed per review returned. Use a multiple of 50 to page through without gaps.
Default: 50
page
integer
Feed page to start from (1-10, 50 reviews per page). Use pagination.next_page from a previous response to continue.
Default: 1
include_reviewer_names
boolean
Return reviewer display names (and profile links where the store shows them). Off by default: authors are 'Reviewer 1', 'Reviewer 2', ... in the order returned.
Default: false
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/reviews/app-store?app_id=570060128&country=us&limit=60" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the App Store Reviews API page.