Search results by day
hive_keyword_ranksRetrieve daily App Store or Google Play keyword rankings as ordered app IDs with rating counts for a chosen storefront, platform, search term, and date range.
Instructions
Who ranks where for any search term in one storefront, day by day: the ordered app ids in that storefront's search results, each with its rating count. One call returns up to 1,000 rows (days × depth); pass the ids to hive_app_details for names. 10 credits for up to 7 days, 20 for up to 30, 40 for up to 90.
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": {
"term": "<term>"
},
"name": "hive_keyword_ranks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | results per day, up to 200 (default 50) | |
| days | No | days back, up to 90 (default 7) | |
| term | Yes | search term, e.g. habit tracker | |
| country | No | storefront code, e.g. us (defaults to us) | |
| platform | No | defaults to ios |