Get Rank Checker positions
get_rank_keyword_dataUse this when the user asks how their tracked keywords rank, which moved, or for the ranking history of a keyword. Reads the data points the GSC Wizard Rank Checker collected for one keyword set (setId from list_rank_keyword_sets): Search Console average positions for the set's country and device, stored once a day. Without keyword: every keyword's impression-weighted position, clicks and impressions over the period (days: 7, 28, 91, 182, 365 or 485; default 7) against the same number of days before, with the change (positive = better) and the ranking URL, plus the daily trend of the set (average position, top 3 / top 10 counts). period.comparable is false when the period before starts earlier than the stored history (period.storedFrom): then there is no previous position, change, new or lost. With keyword: that keyword's daily data points over the period. Lower position is better. Not for keywords outside a set: use get_query_performance.
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": {
"siteUrl": "<siteUrl>",
"setId": "<setId>"
},
"name": "get_rank_keyword_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Period length: 7 (default), 28, 91, 182, 365 or 485 days. | |
| setId | Yes | ||
| keyword | No | One keyword of the set: returns its daily data points instead. | |
| siteUrl | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| setId | No | ||
| trend | No | ||
| device | No | ||
| period | No | ||
| country | No | ||
| history | No | ||
| keyword | No | ||
| setName | No | ||
| siteUrl | No | ||
| keywords | No | ||
| nextStep | No | ||
| emptyBecause | No | ||
| methodLimits | No | ||
| lastCheckedAt | No |