AppStore API endpoint
Returns the total `ratings` count and the 1 to 5 star `histogram` for an App Store app. Identify it with either the numeric track `id` or the bundle ID `app_id`; a bundle ID is resolved to the track ID first, and a non-numeric `id` returns 400. `country` and `lang` are optional.
/appstore/ratingsMCP tool: appstore_ratings
Returns Apple App Store rating aggregates for an app.
Query parameters:
id: optional. App Store track ID. Must be numeric (digits only), e.g. 553834731.app_id: optional. App Store bundle ID, e.g. com.midasplayer.apps.candycrushsaga.country: optional. Two-letter storefront country code.lang: optional. Result language tag.Provide either id or app_id; when only app_id (bundle ID) is given it is resolved to the track ID first. A non-numeric id returns 400; pass a bundle ID as app_id instead.
| Field | In the sample | Value in the sample |
|---|---|---|
| ratings | Has a value | 11,243,559 |
| histogram | Has a value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | No | App Store numeric track ID (digits only) | 553834731 | |
| app_id | string | No | App Store bundle ID | com.midasplayer.apps.candycrushsaga | |
| country | string | No | Two-letter storefront country code | us | |
| lang | string | No | Result language tag | en-us | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/appstore/ratings?country=us&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"score": 4.9,
"ratings": 1200000,
"histogram": {
"1": 1200,
"2": 800,
"3": 2400,
"4": 12000,
"5": 1183600
}
}
}Request schema
No body schema
Response schema
#/definitions/appstore.ratingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | appstore.RatingsResult | No | ||||
| data.histogram | object | No | Number of ratings for each star value, keyed by star value. | |||
| data.ratings | integer | No | Total number of user ratings. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 404 | App not found | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/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/appstore/ratings?country=us&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"