Top Charts

GET 3 Credits / Request /ios/categories/{CATEGORY_ID}/top.json

Top Charts allows you to fetch the most popular applications for a category and type in a country for a device. We return the top 200 applications. Results are updated daily. The first application is the one that has the best rank for the requested chart.

Top Charts Request

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

language: string en

The two letter language (ISO Alpha-2) you want to fetch the application in.

en. Get the list of our language codes, here.

type: string free

The kind of chart this trends object is referring to.

Possible values are: free, paid and grossing

GET /ios/categories/{CATEGORY_ID}/top.json

Request example
GET /ios/categories/7015/top.json?country=es&language=es&device=iphone&type=free&num=20
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/ios/categories/7015/top.json?country=es&language=es&device=iphone&type=free&num=20

Top Charts Response

The response to the Top Charts requests is an ordered list of application snippets. Each application snippet is a JSON hash containing all necessary data to generate a preview of the application as displayed on the App Store search results and top charts.

Object properties
id: number

The ID that Apple has given to the application.

developer: hash

Key/value pairs describing the developer.

devices: array

The list of devices the app is available on. Can contain : ipad, ipod and iphone.

genres: array

The list of category the app is listed on. See the supported categories list to match the category_id to it's human friendly name. The special category_id 0 is used to refer to the global rankings across all categories combined.

icon: string

The URL of the icon as it appears on the App Store.

in_apps: boolean

Flag specifying if the app has in app purchases.

price: string

Price of the application as displayed in the App Store in the target country.

rating: string

Value describing the average rating for the application.

slug: string

URL friendly version of the app name.

title: string

The App name as it appears on the App Store, in the chosen language.

metadata > content: hash

Key/value pairs listing the top 1500 apps (array of application IDs) matching the given term.

CHILD PROPERTIES

application_ids: array

Top 1500 apps (array of application IDs) matching the given criteria in the AppTweak database.

Response Example

{
  "content": [
    {
      "id": 1010677881,
      "title": "World Chef",
      "icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple118/v4/f9/19/20/f9192039-a6fd-3999-ed14-3388fd20bbfb/AppIcon-1x_U007emarketing-85-220-3.png/170x170bb.png",
      "developer": "Social Point",
      "price": "0,00 €",
      "genres": [
        "6014",
        "7009",
        "7015"
      ],
      "devices": [
        "iphone",
        "ipad",
        "ipod"
      ],
      "slug": "world-chef",
      "rating": 4.5,
      "in_apps": true
    }
  ],
  "metadata": {
    "request": {
      "path": "/categories/7015/top.json",
      "store": "ios",
      "params": {
        "country": "us",
        "language": "us",
        "device": "iphone",
        "type": "free",
        "category": 7015,
        "format": "json"
      },
      "performed_at": "2018-10-30 10:42:02 UTC"
    },
    "content": {
      "application_ids": [
        1010677881,
        714796093,
        594753075,
        1068204657,
        1029094059,
        1323901884,
        344532371,
        1089048531,
        911121200,
        1236677535,
        987360477,
        1278869953
      ]
    }
  }
}