App rank for a keyword
keyword_app_metrics_rankingsWhere one app currently ranks in search results for one keyword. The direct answer to "am I ranking for this?". A rank of 0 means the app is not in the results. Costs 2 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>",
"keyword": "<keyword>"
},
"name": "keyword_app_metrics_rankings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cache | No | Use a cached result. True by default; false re-checks the store live (~7s). | |
| store | Yes | Which app store: "android" (Google Play) or "ios" (App Store). | |
| country | Yes | Two-letter ISO country code, e.g. "US", "GB", "DE". | |
| keyword | Yes | A single search term, e.g. "habit tracker". | |
| 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. |