Endpoint Playground
Searches daily top-chart snapshots from the iOS App Store and Google Play (one document per chart × snapshot × rank). With no `date` the latest snapshot is returned (today's chart); pair `app_id` with `sort=date_desc` for an app's rank over time. Store enum: `ios`, `android`. Chart type enum: `top_free`, `top_paid`, `top_grossing`, `new`. Platform enum (Apple device platforms, ios charts only): `phone`, `pad`, `mac`. Sort enum: `rank`, `rank_desc`, `date_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 20 items; 14 fields had a value in every checked item and 1 varied between items.
Sample value profiles: snapshot_date: 2026-10-13; category: 6,014 to 7,019, median 7,006; url: apps.apple.com.
curl 'https://api.crawlora.net/api/v1/datasets/apps-charts/search?store=ios&chart_type=top_free&sort=rank' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over chart-entry title and developer, max 256 characters | |
| store | string | No | ios | Store enum: ios, android |
| chart_type | string | No | top_free | Chart enum: top_free, top_paid, top_grossing, new |
| platform | string | No | Apple device-platform filter, iOS charts only; see platform enum above | |
| collection | string | No | Raw store collection id filter (e.g. topgrossingapplications, GROSSING), max 128 characters | |
| category | string | No | Store category/genre filter, max 128 characters; empty for the overall charts | |
| country | string | No | Exact storefront country filter, max 128 characters | |
| app_id | string | No | Exact app filter — iOS numeric track id or Android package; pair with sort=date_desc for rank history | |
| date | string | No | Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot | |
| sort | string | No | rank | Sort enum: rank, rank_desc, date_desc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "apps-charts",
"items": [
{
"chart_uid": "android:GROSSING::jp:2026-06-19:1",
"store": "android",
"collection": "GROSSING",
"chart_type": "top_grossing",
"country": "jp",
"snapshot_date": "2026-06-19",
"rank": 1,
"app_id": "com.google.android.apps.subscriptions.red",
"title": "Google One",
"developer": "Google LLC",
"free": true,
"url": "https://play.google.com/store/apps/details?id=com.google.android.apps.subscriptions.red"
}
],
"snapshot_date": "2026-06-19",
"page": 1,
"page_size": 20,
"total": 100,
"sort": "rank"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.