Get keyword rank history
Get the rank of one keyword over a date range.
GET https://cotlet.dev/api/v1/accuranker/keywords/{keyword_id}/history
read
Returns one point per date AccuRanker has a rank for, oldest first, with the ranking URL. Dates without a rank check are not filled in. Leave both dates out for the history the keyword shows by default.
Parameters
| Name | Type | Description |
|---|---|---|
| keyword_id string required | string | Keyword ID from list_keywords. |
| period_from string | string | First date, YYYY-MM-DD. |
| period_to string | string | Last date, YYYY-MM-DD. |
Request
curl https://cotlet.dev/api/v1/accuranker/keywords/keyword_8c41d2/history \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("accuranker", "get_keyword_history", {"keyword_id":"keyword_8c41d2"})const result = await cotlet.call('accuranker', 'get_keyword_history', {"keyword_id":"keyword_8c41d2"});cotlet call accuranker get_keyword_history --data '{"keyword_id":"keyword_8c41d2"}'Example response
{
"keyword_id": "k_90311",
"keyword": "rank tracking software",
"history": [
{
"date": "2026-10-16",
"rank": 6,
"url": "https://acme-outdoors.com/pricing"
},
{
"date": "2026-10-23",
"rank": 4,
"url": "https://acme-outdoors.com/pricing"
}
]
}