GooglePlay API endpoint
Returns Google Play reviews for an app by `app_id`. `sort` is `newest` (default), `helpfulness` or `rating`, and `num` is up to 1000 per request (default 100). Each review has its text, score, date, thumbs-up count, app version and any developer reply. Pass `next_pagination_token` back to continue.
/googleplay/reviewsMCP tool: googleplay_reviews
Query parameters:
app_id (required) — Google Play package name, e.g. com.openai.chatgpt.sort — review sort order, default newest. Allowed values: helpfulness, newest, rating.num — maximum number of reviews to return per request, default 100, maximum 1000. A value above the maximum is rejected; page past it with next_pagination_token.country — two-letter storefront country code (ISO-2), default us.lang — two-letter language code (ISO-639), default en.paginate — when true, return only a single page of results; when false (default), pages are followed automatically until num reviews are collected.next_pagination_token — token from a previous response used to fetch the next page.Notable response behavior:
data.data. When more reviews are available than were
returned, data.next_pagination_token is populated; pass it back as
next_pagination_token to continue from where the previous response ended.num is collected across several upstream pages; the response may still carry a
next_pagination_token for reviews beyond num. To read more than the per-request
maximum, follow the token across successive requests./googleplay/app or
/googleplay/list.| Field | Filled in, of 250 checked | Values in the sample |
|---|---|---|
| id | 250 | |
| user_name | 250 | |
| user_image | 250 | play-lh.googleusercontent.com |
| date | 250 | 2026-10-12 |
| score | 250 | 1 to 5, median 5 |
| score_text | 250 | 1 to 5, median 5 |
| url | 250 | play.google.com |
| title | 0 | |
| text | 250 | |
| reply_text | 0 | |
| version | 219 | |
| thumbs_up | 250 | 0 |
| criterias | 7 | median 3 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| app_id | string | Yes | Google Play app id | com.openai.chatgpt | |
| sort | string | No | Sort: helpfulness, newest, rating Allowed values: helpfulness, newest, rating. | newest | |
| num | integer | No | Number of reviews | 100 | |
| country | string | No | Two-letter country code | us | |
| lang | string | No | Two-letter language code | en | |
| paginate | boolean | No | Only fetch the requested page | ||
| next_pagination_token | string | No | Token from a previous response | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/googleplay/reviews?app_id=com.openai.chatgpt&sort=helpfulness&num=10&country=us&lang=en&paginate=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"data": [
{
"id": "5b4e4d89-ce22-4f13-b676-bb3a7aafe278",
"user_name": "Play User",
"user_image": "https://play-lh.googleusercontent.com/a-/sample",
"date": "2026-02-18T12:34:56Z",
"score": 5,
"score_text": "5",
"url": "https://play.google.com/store/apps/details?id=com.openai.chatgpt&reviewId=5b4e4d89-ce22-4f13-b676-bb3a7aafe278",
"title": null,
"text": "Very useful for daily work.",
"reply_text": null,
"version": "1.2026.056",
"thumbs_up": 42,
"criterias": null
}
],
"next_pagination_token": "CscBIr4BAb_yELvAqtSacgExc3y_bO88_b1Q"
}
}Request schema
No body schema
Response schema
#/definitions/googleplay.reviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | googleplay.ReviewsResult | No | ||||
| data.data | array | No | Reviews on this page, newest or sorted as requested. | |||
| data.data[].criterias | array | No | Per-criterion ratings attached to the review, when Google Play shows them. | |||
| data.data[].criterias[].criteria | string | No | Accuracy | Name of the aspect being rated, such as `Accuracy`. | ||
| data.data[].criterias[].rating | integer | No | 5 | Rating given for this aspect. `null` when no rating is shown. | ||
| data.data[].date | string | No | 2026-02-18T12:34:56Z | Time the review was posted, in UTC (RFC 3339). | ||
| data.data[].id | string | No | 5b4e4d89-ce22-4f13-b676-bb3a7aafe278 | Google Play review ID. | ||
| data.data[].reply_date | string | No | 2026-02-20T08:00:00Z | Time the developer replied, in UTC (RFC 3339). | ||
| data.data[].reply_text | string | No | Thanks for the feedback! | Developer's reply to the review. `null` when there is no reply. | ||
| data.data[].score | integer | No | 5 | Star rating the reviewer gave, from 1 to 5. | ||
| data.data[].score_text | string | No | 5 | Star rating as a string, such as `5`. | ||
| data.data[].text | string | No | Very helpful for quick answers and brainstorming. | Body text of the review. | ||
| data.data[].thumbs_up | integer | No | 124 | Number of users who marked the review as helpful. | ||
| data.data[].title | string | No | Great app | Review headline. Currently always `null`. | ||
| data.data[].url | string | No | https://play.google.com/store/apps/details?id=com.openai.chatgpt&reviewId=5b4e4d89-ce22-4f13-b676-bb3a7aafe278 | Google Play link to this review. | ||
| data.data[].user_image | string | No | https://play-lh.googleusercontent.com/a-/ALV-UjVsample | URL of the reviewer's profile picture. | ||
| data.data[].user_name | string | No | Jane Doe | Display name of the reviewer. | ||
| data.data[].version | string | No | 1.2026.056 | App version the review was written for. `null` when not shown. | ||
| data.next_pagination_token | string | No | CscBIr4BAb_yELvAqtSacgExc3y_bO88_b1Q | Token to pass as `next_pagination_token` to fetch the next page of reviews. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/googleplay/reviews?app_id=com.openai.chatgpt&sort=helpfulness&num=10&country=us&lang=en&paginate=true" \
-H "x-api-key: $CRAWLORA_API_KEY"