GooglePlay API endpoint
Returns the ratings-and-reviews breakdown Google Play shows under the details page's device tabs, one entry each for phone, tablet, and Chromebook. Defaults: `country=us`, `lang=en`.
/googleplay/ratingsMCP tool: googleplay_ratings
Query parameters:
app_id: required. Google Play package name. Example: com.openai.chatgpt.country: optional. Two-letter storefront country code. Example: us.lang: optional. Two-letter language code. Example: en.| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| device | 3 | “phone” and 2 other values |
| score | 3 | 4.66 to 4.78, median 4.68 |
| score_text | 3 | 4.7 to 4.8, median 4.7 |
| ratings | 3 | 71,551 to 62,281,258, median 2,009,652 |
| reviews | 3 | 11,236 to 202,169, median 189,773 |
| histogram | 3 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| app_id | string | Yes | Google Play package name | com.openai.chatgpt | |
| country | string | No | Two-letter storefront country code | us | |
| lang | string | No | Two-letter language code | en | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/googleplay/ratings?app_id=com.openai.chatgpt&country=us&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": [
{
"device": "phone",
"score": 4.7,
"score_text": "4.7",
"ratings": 326841,
"reviews": 8946,
"histogram": {
"1": 17372,
"2": 6514,
"3": 2170,
"4": 24973,
"5": 275802
}
},
{
"device": "tablet",
"score": 4,
"score_text": "4.0",
"ratings": 29051,
"reviews": 4667,
"histogram": {
"1": 4898,
"2": 1604,
"3": 928,
"4": 2533,
"5": 19085
}
},
{
"device": "chromebook",
"score": 4.3,
"score_text": "4.3",
"ratings": 18,
"reviews": 7,
"histogram": {
"1": 1,
"2": 0,
"3": 2,
"4": 5,
"5": 10
}
}
]
}Request schema
No body schema
Response schema
#/definitions/googleplay.ratingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | array | No | ||||
| data[].device | string | No | phone | Device type the rating breakdown covers: `phone`, `tablet` or `chromebook`. | ||
| data[].histogram | object | No | Number of ratings at each star level on this device type, keyed `1` to `5`. | |||
| data[].ratings | integer | No | 326809 | Total number of star ratings on this device type. | ||
| data[].reviews | integer | No | 8946 | Total number of written reviews on this device type. | ||
| data[].score | number | No | 4.7 | Average star rating on this device type, out of 5. | ||
| data[].score_text | string | No | 4.7 | Average rating on this device type as Google Play displays it, such as `4.7`. | ||
| 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/ratings?app_id=com.openai.chatgpt&country=us&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"