API Reference
Use Crawlora's App Store Scraper API endpoints to extract supported public AppStore data as structured JSON. This documentation covers 12 active endpoints including Retrieve full App Store app details, Retrieve apps by developer ID, Retrieve an App Store device or Arcade editorial landing page, Retrieve an App Store category-scoped editorial page, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as dev_id, device, category_id, id, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/appstore/search?num=10&page=1&country=us&lang=en&ids_only=true&platform=phone" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/appstore/appapiKey1 credit/requestReturns normalized app metadata from the App Store lookup API. Provide either `id` (numeric track ID) or `app_id` (bundle ID). `id`/`app_id` can identify an iPhone, iPad, or Mac App Store listing.
Required params: None
/appstore/developer/{dev_id}apiKey1 credit/requestReturns App Store apps associated with a specific developer artist ID.
Required params: dev_id:path
/appstore/editorialapiKey1 credit/requestReturns the curated editorial shelves from one of Apple's per-device App Store landing pages (the same content shown by apps.apple.com's device switcher). `device` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`. `section` enum: `main` (the device's Today/Discover/Apps & Games landing page), `arcade` (the device's Apple Arcade landing page). Watch has no Arcade page — `device=watch` with `section=arcade` returns `400`.
Required params: device:query
/appstore/editorial/categoryapiKey1 credit/requestReturns the curated editorial shelves for one device category page (e.g. "Entertainment Apps for Vision"). `category_id` is a numeric, device-specific editorial page ID — not a static enum — discovered from an `appstore_editorial` response for the SAME `device`, in its "Browse by Category" shelf items' `destination_id` field. `device` enum: `iphone`, `ipad`, `mac`, `vision`, `watch`, `tv`.
Required params: device:query, category_id:query
/appstore/listapiKey1 credit/requestReturns 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.
Required params: None
/appstore/privacy/{id}apiKey1 credit/requestReturns the app privacy cards shown on the App Store page, including data categories and purposes.
Required params: id:path
/appstore/ratingsapiKey1 credit/requestReturns total ratings count and the 1-5 star histogram shown on the App Store product page.
Required params: None
/appstore/reviewsapiKey3 credits/requestReturns one page of customer reviews for an app. Provide either `id` (numeric track ID) or `app_id` (bundle ID).
Required params: None
/appstore/searchapiKey1 credit/requestReturns App Store search results for a term. Set `ids_only=true` to return only app IDs. `platform` enum: `phone`, `pad`, `mac`.
Required params: term:query
/appstore/similarapiKey1 credit/requestReturns the related apps shown on the App Store product page. Provide either `id` (numeric track ID) or `app_id` (bundle ID).
Required params: None
/appstore/suggest/{term}apiKey1 credit/requestReturns suggested search terms for the given partial keyword.
Required params: term:path
/appstore/version-history/{id}apiKey1 credit/requestReturns the version history entries shown in the App Store "What's New" section.
Required params: id:path
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Retrieve full App Store app details | /appstore/app | GET | 1 credit/request | None | View docs | Try endpoint |
| Retrieve apps by developer ID | /appstore/developer/{dev_id} | GET | 1 credit/request | dev_id:path | View docs | Try endpoint |
| Retrieve an App Store device or Arcade editorial landing page | /appstore/editorial | GET | 1 credit/request | device:query | View docs | Try endpoint |
| Retrieve an App Store category-scoped editorial page | /appstore/editorial/category | GET | 1 credit/request | device:query, category_id:query | View docs | Try endpoint |
| Retrieve App Store collection rankings | /appstore/list | GET | 1 credit/request | None | View docs | Try endpoint |
| Retrieve App Store privacy disclosures | /appstore/privacy/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |
| Retrieve App Store ratings histogram | /appstore/ratings | GET | 1 credit/request | None | View docs | Try endpoint |
| Retrieve App Store reviews | /appstore/reviews | GET | 3 credits/request | None | View docs | Try endpoint |
| Search the App Store | /appstore/search | GET | 1 credit/request | term:query | View docs | Try endpoint |
| Retrieve "You Might Also Like" apps | /appstore/similar | GET | 1 credit/request | None | View docs | Try endpoint |
| Retrieve App Store search suggestions | /appstore/suggest/{term} | GET | 1 credit/request | term:path | View docs | Try endpoint |
| Retrieve App Store version history | /appstore/version-history/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |