Datasets

Search the app-charts dataset

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).

get/datasets/apps-charts/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/apps-charts/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over chart-entry title and developer, max 256 characters

store'ios' | 'android'

Store enum: ios, android

chart_type'top_free' | 'top_paid' | 'top_grossing' | 'new'

Chart enum: top_free, top_paid, top_grossing, new

platformstring

Apple device-platform filter, iOS charts only; see platform enum above

collectionstring

Raw store collection id filter (e.g. topgrossingapplications, GROSSING), max 128 characters

categorystring

Store category/genre filter, max 128 characters; empty for the overall charts

countrystring

Exact storefront country filter, max 128 characters

app_idstring

Exact app filter — iOS numeric track id or Android package; pair with sort=date_desc for rank history

datestring

Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot

sort'rank' | 'rank_desc' | 'date_desc'

Sort enum: rank, rank_desc, date_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.