Skip to content
Gridlode
Docs · Reference

Google Play Reviews

GET /v1/reviews/google-play1 credit / reviewcache 360 min

Google Play user reviews of any app, newest, most relevant or by rating, with an optional 1-5 star filter, in any language and country: rating, text, date, thumbs-up count, app version reviewed and the developer's reply with its date. Up to 1,000 reviews per call, with a continuation token to keep paging. Collected as a signed-out visitor; reviewer names are pseudonymized unless you ask for them. Billed per review returned; blocked or failed requests are free.

Query parameters

app_id
string · required
Google Play package name, e.g. com.duolingo, or a play.google.com app URL.
sort
string
Review order: newest first, Google's 'most relevant', or by rating.
Default: "newest"
Allowed: newest, relevant, rating
stars
string
Only reviews with this star rating (1-5).
Default: null
limit
integer
Maximum reviews to return (1-1000). Billed per review returned.
Default: 100
continuation_token
string
pagination.next_token from a previous response, to continue where it stopped. Use the same app_id, sort, stars, hl and gl.
Default: null
hl
string
Language of the reviews to read, e.g. en, de, pt-BR. Google Play shows reviews written in (or translated to) this language.
Default: "en"
gl
string
Two-letter country whose Play Store to read, e.g. us, gb, in.
Default: "us"
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/google-play?app_id=com.duolingo&sort=newest&limit=120" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Play Reviews API page.