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
Your AppTweak API Key.
Path parameters
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}" ""

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": "",
      "developer": "TikTok Inc.",
      "price": "",
      "genres": [
      "rating": 4.4,
      "ratings_count": 20270577,
      "power": 100
      "id": "com.owlreality.zynn",
      "title": "Zynn",
      "icon": "",
      "developer": "OWLII INC.",
      "price": "",
      "genres": [
      "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": [