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.
This endpoint is deprecated. To continue accessing Top Charts results, we recommend switching to our new API. Contact our team to migrate your plan.
The two letter country code (ISO Alpha-2) you want to fetch the app in.
us. Get the list of our country codes, here.
The device you want to fetch the application for.
iphone or ipad
The kind of chart this trends object is referring to.
Possible values are: free, paid and grossing
GET /ios/categories/7015/top.json?country=es&device=iphone&type=free
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/categories/7015/top.json?country=es&device=iphone&type=free"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.
The ID that Apple has given to the application.
Developer's name.
The list of devices the app is available on. Can contain : ipad, ipod and iphone.
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.
The URL of the icon as it appears on the App Store.
Flag specifying if the app has in app purchases.
Price of the application as displayed in the App Store in the target country.
Value describing the average rating for the application.
URL friendly version of the app name.
The App name as it appears on the App Store.
Top 500 apps (array of application IDs) matching the given criteria in the AppTweak database. If the type is grossing, then only the top 200 are returned.
{
"content": [
{
"id": 1195621598,
"title": "Homescapes",
"icon": "https://is4-ssl.mzstatic.com/image/thumb/Purple113/v4/b3/c6/f7/b3c6f7e4-8618-64ea-c6ae-767fe2013745/AppIcon-0-0-1x_U007emarketing-0-0-0-10-0-85-220.png/1024x1024bb.jpg",
"developer": "Playrix",
"price": "0,00 €",
"genres": [
6014,
6016,
7012,
7015
],
"devices": [
"iphone",
"ipad",
"ipod"
],
"slug": "homescapes",
"rating": 4.4,
"in_apps": true,
"ratings_count": 51036,
"power": 96.8
}
],
"metadata": {
"request": {
"path": "/categories/7015/top.json",
"store": "ios",
"params": {
"country": "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
]
}
}
}