List Google Play app reviews
List Google Play reviews of an app, newest or most relevant first, with star filters and developer replies.
Headers
Get your API keyAPI key (`sfk_...`)
Google Play app id (the Android package name), e.g. `com.spotify.music`. A Google Play app link is also accepted.
min 1 chars · max 400 chars
Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, charts and search results follow it. Default: `us`.
pattern: ^[a-z]{2}$
Language of the text, e.g. `en`, `de`, `pt-BR` or `ja`. Names, descriptions and labels follow it. Default: `en`.
min 2 chars · max 10 chars
`recent` (newest first), `relevant` (the store's own ranking) or `rating` (by stars). Default: `recent`.
one of: recent, relevant, rating
Only reviews with this many stars, 1 to 5. Default: all.
≥ 1 · ≤ 5
Reviews per page, 1-150. Default: 40.
≥ 1 · ≤ 150
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 3000 chars
Endpoint-specific response payload.
`not_found` when Google Play has no such app or developer. An app removed from the store and one that never existed look the same.
one of: found, not_found
Storefront the reviews are from.
Language of the reviews.
The app id asked for.
Sort used.
one of: recent, relevant, rating
Star filter used; null for all reviews.
Reviews on this page, in the order of the sort.
Review id.
Review text.
Stars given (1 to 5).
≥ 1 · ≤ 5
When the review was posted or last edited (ISO-8601, UTC).
How many people marked the review helpful.
App version the reviewer had installed, when known.
The reviewer.
Display name shown in the store.
The reviewer's profile picture.
The developer's reply, when there is one.
Name the reply is signed with, usually the developer.
Reply text.
When the reply was posted (ISO-8601, UTC).
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/google-play/apps/com.spotify.music/reviews?sort=recent&limit=20" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of Google Play reviews.