App Category Ranking — History​

GET
/apps/category-rankings/history

An app's category chart position over time.

Authorizations​

bearerAuth

Your appmanai API key as a Bearer token.

Type
HTTP (bearer)

Parameters​

Query Parameters

store*

Which app store.

Type
string
Required
Valid values
"android""ios"
country*

Two-letter ISO country code. Case-insensitive.

Type
string
Required
Example"US"
Min Length
2
Max Length
2
Pattern
"^[A-Za-z]{2}$"
package*

App package / bundle id — com.discord on Android, a numeric id on iOS. Use /apps/search to resolve a name.

Type
string
Required
Example"com.discord"
category*

Category tag from /resources/categories.

Type
string
Required
sub_category

Chart inside the category — topselling_free, topgrossing, topselling_paid on Google Play; top-free, top-paid on the App Store.

Type
string
limit

How many rows to return, up to 500.

Type
integer
Minimum
1
Maximum
500

Responses​

Successful response.

application/json
JSON
{
  
"status": 200,
  
"meta": {
  
  
"exec_time": 0.058,
  
  
"cache": false,
  
  
"count": 236
  
},
  
"data": {
  
  
"category_ranks": [
  
  
  
{
  
  
  
  
"rank": 23,
  
  
  
  
"refreshed_at": "2026-01-20"
  
  
  
},
  
  
  
{
  
  
  
  
"rank": 23,
  
  
  
  
"refreshed_at": "2026-01-21"
  
  
  
},
  
  
  
{
  
  
  
  
"rank": 23,
  
  
  
  
"refreshed_at": "2026-01-22"
  
  
  
}
  
  
]
  
}
}

Samples​

Powered by VitePress OpenAPI