Get rank tracking
Positions of the tracked keywords of a project by location, device and timeframe.
GET https://cotlet.dev/api/v1/ubersuggest/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. |
Request
curl "https://cotlet.dev/api/v1/ubersuggest/rank-tracking?project=project" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("ubersuggest", "get_rank_tracking", {"project":"project"})const result = await cotlet.call('ubersuggest', 'get_rank_tracking', {"project":"project"});cotlet call ubersuggest get_rank_tracking --data '{"project":"project"}'Example response
{
"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"
}