Top Charts — Current
GET
/categories/top-apps
The apps at the top of a category chart (top free, top grossing, top paid).
Authorizations
bearerAuth
Your appmanai API key as a Bearer token.
Type
HTTP (bearer)
Parameters
Query Parameters
store*
Which app store.
Type
Requiredstring
Valid values
"android""ios"country*
Two-letter ISO country code. Case-insensitive.
Type
Requiredstring
Example
"US"Min Length
2Max Length
2Pattern
"^[A-Za-z]{2}$"category
Category tag from /resources/categories.
Type
string
sub_category
Chart inside the category — topselling_free, topgrossing, topselling_paid on Google Play; top-free, top-paid on the App Store.
Type
string
extended
Return full app profiles instead of package ids and ranks.
Type
boolean
show_diff
Include each app's movement since the previous chart.
Type
boolean
date
Chart date. Defaults to the latest.
Type
string
Format
"date"limit
How many rows to return, up to 500.
Type
integer
Minimum
1Maximum
500Responses
Successful response.
application/json
JSON "status": 200, "meta": { "exec_time": 0.013, "cache": false, "count": 10 }, "data": { "top_apps": [ { "package": "com.openai.chatgpt", "rank": 1, "refreshed_at": "2026-09-17" }, { "package": "com.ss.android.ttmd.video", "rank": 2, "refreshed_at": "2026-09-17" }, { "package": "com.ss.android.ugc.tiktok.pro", "rank": 3, "refreshed_at": "2026-09-17" } ] }
{
}