Top Chart

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

Top Chart 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 Chart 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.

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 /android/categories/{CATEGORY_ID}/top.json

Request example
GET /android/categories/SOCIAL/top.json?country=us&language=us
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/android/categories/SOCIAL/top.json?country=us&language=us

Top Chart Response

The response to the Top Chart 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 Google has given to the application.

developer: string

Developer's name.

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 Google Play Store.

price: string

Price of the application as displayed in the Google Play Store in the target country.

rating: string

Value describing the average rating for the application.

title: string

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

Response Example

{
  "content": [
    {
      "id": "com.zhiliaoapp.musically",
      "title": "TikTok",
      "icon": "https://lh3.googleusercontent.com/RSfWDd8i3_sQNBT2AoN2D4s2O0i8PFqWLMFR4gxn16QikaL3KClqc5SUN7dCjNJPAg",
      "developer": "musical.ly",
      "price": "",
      "genres": [
        "SOCIAL"
      ],
      "rating": 4.361149787902832
    },
    {
      "id": "com.snapchat.android",
      "title": "Snapchat",
      "icon": "https://lh3.googleusercontent.com/A-hQknkTsGW5rzEMxHoNB_9S36LNYeRbY5dhi0ngYWBoO0XfahBmR-CKnD6S2J4Lnm0",
      "developer": "Snap Inc",
      "price": "",
      "genres": [
        "SOCIAL"
      ],
      "rating": 4.047216415405273
    }
  ],
  "metadata": {
    "request": {
      "path": "/categories/SOCIAL/top.json",
      "store": "android",
      "params": {
        "country": "us",
        "language": "us",
        "type": "free",
        "category": "SOCIAL",
        "format": "json"
      },
      "performed_at": "2018-11-13 09:40:58 UTC"
    },
    "content": {
      "application_ids": [
        "com.zhiliaoapp.musically",
        "com.snapchat.android",
        "com.instagram.android",
        "com.facebook.katana",
        "com.enflick.android.TextNow",
        "com.pinterest",
        "com.facebook.lite",
        "com.boo.boomoji",
        "com.pof.android"
      ]
    }
  }
}