App category rank over time
app_category_rankings_historyAn app's position in a category chart across past days — the series to chart when asking whether an app is climbing or sliding. Costs 6 credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"store": "<store>",
"country": "<country>",
"package": "<package>",
"category": "<category>"
},
"name": "app_category_rankings_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many of the most recent days to return, up to 365. 90 by default. | |
| store | Yes | Which app store: "android" (Google Play) or "ios" (App Store). | |
| country | Yes | Two-letter ISO country code, e.g. "US", "GB", "DE". | |
| package | Yes | App package / bundle id, e.g. "com.discord" (Android) or a numeric App Store id. If you only have the app name, call app_search first to resolve it. | |
| category | Yes | Category tag from list_categories. Required. | |
| sub_category | No | Chart inside the category: "topselling_free", "topgrossing", "topselling_paid" on Google Play; "top-free", "top-paid" on the App Store. list_categories has the valid tags. |