Keyword ranks
get_keywordsRetrieve keyword ranks for a specific app in a chosen App Store or Google Play country to track visibility and distinguish unmeasured queries from absent rankings.
Instructions
Keyword ranks for one app in one App Store / Google Play country. THREE STATES ARE DISTINCT: measured=false means the query could not be measured, rank=null means it was measured but the app is absent from the top results, rank= is the rank. Never collapse them into one — counting an unmeasured day as zero produces a false answer.
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": {
"appId": "<appId>"
},
"name": "get_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | app id from list_apps | |
| country | No | country code, e.g. tr, us (defaults to the app's first country) | |
| platform | No | defaults to ios |