Endpoint Playground
Returns ranked App Store apps from an iTunes RSS collection, optionally expanded to full lookup details. `collection` enum: `topfreeapplications`, `toppaidapplications`, `topgrossingapplications`, `topfreeipadapplications`, `toppaidipadapplications`, `topgrossingipadapplications`, `topmacapps`, `topfreemacapps`, `topgrossingmacapps`, `toppaidmacapps`, `newapplications`, `newfreeapplications`, `newpaidapplications`. Of the Mac collections, only `topfreemacapps` currently returns ranked apps — `topmacapps`, `topgrossingmacapps`, and `toppaidmacapps` are accepted but Apple's feed for them is currently empty. There is no separate Games `collection` — combine any collection with `category=6014` (or a Games subgenre ID, e.g. `7012` for Puzzle) to get its Games-only equivalent, e.g. Top Free Games. See the endpoint markdown for the full category ID table.
14 Oct 2026: 40 items; 15 fields had a value in every checked item.
Sample value profiles: released: 2008-12-03 to 2026-09-08; title: “Muse from Meta” and 39 other values; icon: is1-ssl.mzstatic.com.
curl 'https://api.crawlora.net/api/v1/appstore/list' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| collection | string | No | Chart collection slug, see description for the full enum | |
| category | integer | No | Numeric App Store category ID, see description for the full enum; e.g. 6014 = Games, 7012 = Games/Puzzle | |
| country | string | No | Two-letter storefront country code | |
| lang | string | No | Result language tag | |
| num | integer | No | Number of apps to return | |
| full_detail | boolean | No | Expand each app via lookup API |
{
"code": 200,
"msg": "OK",
"data": [
{
"id": "6448311069",
"title": "ChatGPT",
"developer": "OpenAI",
"score": 4.9,
"url": "https://apps.apple.com/us/app/chatgpt/id6448311069"
}
]
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.