ToolzerHub Docs

List top chart apps (v1)

Returns up to 100 apps from an App Store chart in rank order: top free, paid or grossing for iPhone or iPad, or new apps, in any storefront, optionally for one genre. Grossing, iPad, new and genre charts also carry price and summary.

1 credit / requestBilled only on success
GET
/v1/app-store/charts

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

country?string

App Store storefront, as a two-letter country code.

Match^[A-Z]{2}$
Default"US"
chart?string

top-free, top-paid, top-grossing, the same three for iPad (top-free-ipad ...), or new for new apps.

Default"top-free"

Value in

  • "top-free"
  • "top-paid"
  • "top-grossing"
  • "top-free-ipad"
  • "top-paid-ipad"
  • "top-grossing-ipad"
  • "new"
genre?string

App Store genre id, such as 6014 Games, 6015 Finance or 7014 Role Playing. Omit for all apps.

limit?integer

Maximum ranked apps to return.

Range1 <= value <= 100
Default100
curl -X GET "https://example.com/v1/app-store/charts" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "country": "string",    "chart": "top-free",    "genre": "string",    "apps": [      {        "rank": 0,        "app_id": "string",        "name": "string",        "developer_id": "string",        "developer_name": "string",        "release_date": "string",        "kind": "string",        "artwork_url": "string",        "genres": [          {            "genre_id": "string",            "name": "string",            "url": "string"          }        ],        "app_store_url": "string",        "price": 0,        "currency": "string",        "summary": "string"      }    ]  },  "details": {    "reason": "no_results",    "message": "string"  }}