Endpoint Playground

Try the Facet the app-store charts dataset API

Returns up to 50 chart-rank facet buckets ordered by count, using the same filters as `datasets_apps_charts_search`. Page and page_size do not change the aggregation. A snapshot_date facet without date spans all history; other facets use the search date scope, including the latest-snapshot default when applicable and full history for a single app or date_desc sort. Facet enum: `store`, `collection`, `chart_type`, `platform`, `category`, `country`, `app_id`, `snapshot_date`, `free`. Store enum: `ios`, `android`. Chart type enum: `top_free`, `top_paid`, `top_grossing`, `new`. Platform enum: `phone`, `pad`, `mac`. Dataset Playground requests query indexed data and do not apply proxy routing.

Request: GET /datasets/apps-charts/facets
Cost: 1 credit/request
Auth: apiKey

Facet the app-store charts dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/apps-charts/facets?facet=collection&store=ios&chart_type=top_free&platform=phone&sort=rank' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	collection	Facet field
q	string	No		Full-text query
store	string	No	ios	Store enum: ios, android
collection	string	No		Raw store collection id filter (e.g. topgrossingapplications, GROSSING), max 128 characters
chart_type	string	No	top_free	Chart type enum: top_free, top_paid, top_grossing, new
platform	string	No	phone	Apple device platform enum (iOS charts only): phone, pad, mac
category	string	No		Exact store category
country	string	No		Storefront country
app_id	string	No		Exact store app id
date	string	No		Chart snapshot date, yyyy-MM-dd
free	boolean	No		Filter by free/paid status
sort	string	No	rank	Validated search sort; bucket order stays count-desc, and time-series date_desc keeps its search history scope
page	integer	No		Result page, 1-based
page_size	integer	No		Page size, default 20 and max 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-charts",
    "facet": "collection",
    "items": [
      {
        "value": "GROSSING",
        "count": 10
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Discover Apple Books dataset values Get an Apple Books record Search Apple Books records Facet stored Apple Maps places Get a stored Apple Maps place Find nearby stored Apple Maps places Search stored Apple Maps places All 165 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.datasetFacetResponseDocDatasets

GET /datasets/apps-charts/facets

Discover values in the app-charts dataset

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet field · allowed: store, collection, chart_type, platform, category, country, app_id, snapshot_date, free

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

datasets_apps_charts_facets

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-charts",
    "facet": "collection",
    "items": [
      {
        "value": "GROSSING",
        "count": 10
      }
    ]
  }
}

Endpoint Playground

Try the Facet the app-store charts dataset API

Request: GET /datasets/apps-charts/facets
Cost: 1 credit/request
Auth: apiKey

Facet the app-store charts dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/apps-charts/facets?facet=collection&store=ios&chart_type=top_free&platform=phone&sort=rank' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	collection	Facet field
q	string	No		Full-text query
store	string	No	ios	Store enum: ios, android
collection	string	No		Raw store collection id filter (e.g. topgrossingapplications, GROSSING), max 128 characters
chart_type	string	No	top_free	Chart type enum: top_free, top_paid, top_grossing, new
platform	string	No	phone	Apple device platform enum (iOS charts only): phone, pad, mac
category	string	No		Exact store category
country	string	No		Storefront country
app_id	string	No		Exact store app id
date	string	No		Chart snapshot date, yyyy-MM-dd
free	boolean	No		Filter by free/paid status
sort	string	No	rank	Validated search sort; bucket order stays count-desc, and time-series date_desc keeps its search history scope
page	integer	No		Result page, 1-based
page_size	integer	No		Page size, default 20 and max 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-charts",
    "facet": "collection",
    "items": [
      {
        "value": "GROSSING",
        "count": 10
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.datasetFacetResponseDocDatasets

GET /datasets/apps-charts/facets

Discover values in the app-charts dataset

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet field · allowed: store, collection, chart_type, platform, category, country, app_id, snapshot_date, free

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

datasets_apps_charts_facets

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apps-charts",
    "facet": "collection",
    "items": [
      {
        "value": "GROSSING",
        "count": 10
      }
    ]
  }
}