Get rank tracking
Positions of the tracked keywords of a project by location, device and timeframe.
MCP tool ubersuggest_read → get_rank_tracking
read
Returns the Average Position and each tracked keyword with its position at the end and at the start of the timeframe. A null position is Not Ranked, outside the top 100. Rankings update weekly, so a new keyword has no position until the next update. Returns up to 50 keywords a page; pass next_cursor back as cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| project string required | string | Project domain, e.g. greenleafcoffee.com. |
| location string | string | A tracked location such as United States. Default: all locations. |
| device enum | enum | desktop or mobile. Mobile only has data when it is enabled in the project settings. Default: desktop. |
| timeframe enum | enum | last_2_weeks or last_month. Default: last_2_weeks. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ubersuggest_read",
"arguments": {
"operation": "get_rank_tracking",
"arguments": {
"project": "project"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"project": "greenleafcoffee.com",
"location": "United States",
"device": "desktop",
"timeframe": "last_month",
"average_position": 31,
"previous_average_position": 34,
"keywords": [
{
"keyword": "cold brew coffee beans",
"position": 7,
"previous_position": 9
},
{
"keyword": "single origin coffee beans",
"position": 18,
"previous_position": 18
},
{
"keyword": "coffee gift box",
"position": 52,
"previous_position": 61
},
{
"keyword": "coffee subscription box uk",
"position": null,
"previous_position": null
},
{
"keyword": "arabica bean wholesale",
"position": null,
"previous_position": null
}
],
"total": 46,
"next_cursor": "1"
},
"isError": false
}