AppStore API endpoint
Returns an App Store app's version history, as shown under "What's New", by numeric track id, for an optional storefront country and language. Each entry has the version number, release date and timestamp, and release notes. A non-numeric id returns `400`.
/appstore/version-history/{id}MCP tool: appstore_version_history
Returns release notes and versions for an Apple App Store app.
Path parameters:
id: required. App Store track ID. Must be numeric (digits only), e.g. 324684580. A non-numeric id returns 400.Query parameters:
country: optional. Two-letter storefront country code.lang: optional. Result language tag.| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| version_display | 25 | |
| release_notes | 25 | Bug fixes and small improvement… in all 25 |
| release_date | 25 | 2026-05-11 to 2026-10-06 |
| release_timestamp | 25 | 2026-05-11 to 2026-10-06 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | App Store numeric track ID (digits only) | 553834731 | |
| 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/version-history/553834731?country=us&lang=en" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": [
{
"version": "1.2026.001",
"released_at": "2026-02-17",
"notes": "Bug fixes and performance improvements."
}
]
}Request schema
No body schema
Response schema
#/definitions/appstore.versionHistoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | array | No | ||||
| data[].release_date | string | No | Release date of the version, as `YYYY-MM-DD`. | |||
| data[].release_notes | string | No | Release notes of the version. | |||
| data[].release_timestamp | string | No | Release time of the version, in RFC 3339. | |||
| data[].version_display | string | No | Version number as shown on the App Store. | |||
| 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/version-history/553834731?country=us&lang=en" \
-H "x-api-key: $CRAWLORA_API_KEY"