Skip to content

App Category Ranking — Start ranks​

GET
/apps/category-rankings/start

Where each app first entered a chart, from a given date.

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}$"
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
packages*

Repeatable, up to 20. Each entry is package:min_date, e.g. com.discord:2026-01-01. The start date is required — without it the call is rejected.

Type
array
Required
Max Items
20

Responses​

Successful response.

application/json
JSON
{
  
"status": 200,
  
"meta": {
  
  
"exec_time": 0.066,
  
  
"cache": false,
  
  
"count": 1
  
},
  
"data": {
  
  
"start_ranks": [
  
  
  
{
  
  
  
  
"package": "com.discord",
  
  
  
  
"start_rank": 19
  
  
  
}
  
  
]
  
}
}

Samples​

Powered by VitePress OpenAPI