Skip to main content
GET
/
projects
/
{projectId}
/
rankings
/
keywords
/
{keywordId}
/
history
curl "https://app.ranked.ai/api/v1/projects/{projectId}/rankings/keywords/{keywordId}/history" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": {
    "keyword_id": "abc-123",
    "keyword": "tree care services sioux city",
    "history": [
      {
        "check_date": "2026-05-14",
        "desktop_position": 5,
        "mobile_position": 3,
        "ai_mode_position": 3,
        "maps_position": 3,
        "featured_snippet": false,
        "local_pack_position": null
      }
    ],
    "summary": {
      "best_position": 1,
      "worst_position": 12,
      "data_points": 30
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://dev.ranked.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns daily position data across all search channels for a tracked keyword.

Path parameters

projectId
string
required
Project UUID
keywordId
string
required
Keyword UUID (from the keywords list endpoint)

Query parameters

date_from
string
Start date (ISO 8601). Defaults to 90 days ago.
date_to
string
End date (ISO 8601). Defaults to today.
curl "https://app.ranked.ai/api/v1/projects/{projectId}/rankings/keywords/{keywordId}/history" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": {
    "keyword_id": "abc-123",
    "keyword": "tree care services sioux city",
    "history": [
      {
        "check_date": "2026-05-14",
        "desktop_position": 5,
        "mobile_position": 3,
        "ai_mode_position": 3,
        "maps_position": 3,
        "featured_snippet": false,
        "local_pack_position": null
      }
    ],
    "summary": {
      "best_position": 1,
      "worst_position": 12,
      "data_points": 30
    }
  }
}