Top Charts

GET 3 Credits / Request /android/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
CATEGORY_ID:
The category for which you want to get the top charts. (which can be found here)
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&type=free
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/android/categories/SOCIAL/top.json?country=us&language=us&type=free"

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

metadata > application_ids: array

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

Response Example

{
  "content": [
    {
      "id": "com.zhiliaoapp.musically",
      "title": "TikTok - Make Your Day",
      "icon": "https://lh3.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA",
      "developer": "TikTok Inc.",
      "price": "",
      "genres": [
        "SOCIAL"
      ],
      "rating": 4.4,
      "ratings_count": 20270577,
      "power": 100
    },
    {
      "id": "com.owlreality.zynn",
      "title": "Zynn",
      "icon": "https://lh3.googleusercontent.com/pWAmBQKV4QH_PSYbs9Fk9Pk-Whj11jGoqvp4crzs0340n4e7x3-HDSYAauSOVLkSiUPh",
      "developer": "OWLII INC.",
      "price": "",
      "genres": [
        "SOCIAL"
      ],
      "rating": 4.6,
      "ratings_count": 3619,
      "power": 82.4
    }
  ],
  "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"
      ]
    }
  }
}