Google Play

List Google Play app reviews

List Google Play reviews of an app, newest or most relevant first, with star filters and developer replies.

GET/v1/google-play/apps/{appId}/reviews
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
7
appIdstringrequiredpath

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

countrystringoptionalquery

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}$

languagestringoptionalquery

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

sortstringoptionalquery

`recent` (newest first), `relevant` (the store's own ranking) or `rating` (by stars). Default: `recent`.

one of: recent, relevant, rating

starsintegeroptionalquery

Only reviews with this many stars, 1 to 5. Default: all.

≥ 1 · ≤ 5

limitintegeroptionalquery

Reviews per page, 1-150. Default: 40.

≥ 1 · ≤ 150

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 3000 chars

Response fields
30

Endpoint-specific response payload.

datalookupStatus
string

`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

datastorefront
string

Storefront the reviews are from.

datalanguage
string

Language of the reviews.

dataappId
string

The app id asked for.

datasort
string

Sort used.

one of: recent, relevant, rating

datastars
integernullable

Star filter used; null for all reviews.

Reviews on this page, in the order of the sort.

datareviews[]id
string

Review id.

datareviews[]body
string

Review text.

datareviews[]rating
integer

Stars given (1 to 5).

≥ 1 · ≤ 5

datareviews[]postedAt
stringnullable

When the review was posted or last edited (ISO-8601, UTC).

datareviews[]helpfulCount
integernullable

How many people marked the review helpful.

datareviews[]appVersion
stringnullable

App version the reviewer had installed, when known.

The reviewer.

datareviews[]authorname
string

Display name shown in the store.

datareviews[]authoravatar
stringnullable

The reviewer's profile picture.

The developer's reply, when there is one.

datareviews[]developerReplyauthor
stringnullable

Name the reply is signed with, usually the developer.

datareviews[]developerReplybody
string

Reply text.

datareviews[]developerReplypostedAt
stringnullable

When the reply was posted (ISO-8601, UTC).

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.