Skip to main content
GET
/
projects
/
{projectId}
/
rankings
/
keywords
curl "https://app.ranked.ai/api/v1/projects/{projectId}/rankings/keywords?limit=10" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "0e982fa1-a846-4e61-98ba-8811fafe892c",
      "keyword": "tree care services sioux city",
      "location": "Sioux City, Iowa, United States",
      "location_code": 1016030,
      "target_url": "https://siouxcitytreeco.com",
      "device": "desktop",
      "language_code": "en",
      "desktop_position": 8,
      "mobile_position": 3,
      "ai_mode_position": 3,
      "maps_position": 3,
      "desktop_url": "https://siouxcitytreeco.com/",
      "mobile_url": "https://siouxcitytreeco.com/",
      "ai_mode_url": "https://siouxcitytreeco.com/",
      "maps_url": "https://siouxcitytreeco.com/",
      "featured_snippet": false,
      "local_pack_position": null,
      "monthly_search_volume": null,
      "net_change": 93,
      "tags": [],
      "last_checked": "2026-05-16T00:10:17.701+00:00",
      "created_at": "2026-03-14T18:24:05.660Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 20,
      "limit": 10,
      "offset": 0,
      "has_more": true
    }
  }
}

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 tracked keywords with current positions across all search channels, net position change, and metadata.

Path parameters

projectId
string
required
Project UUID

Query parameters

limit
number
default:"50"
Maximum keywords to return (max: 1000)
offset
number
default:"0"
Number of keywords to skip
device
string
default:"all"
Filter by device: all, desktop, or mobile
date_from
string
Start date for position change calculation (ISO 8601, e.g., 2026-04-01)
date_to
string
End date for position change calculation (ISO 8601)
curl "https://app.ranked.ai/api/v1/projects/{projectId}/rankings/keywords?limit=10" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "0e982fa1-a846-4e61-98ba-8811fafe892c",
      "keyword": "tree care services sioux city",
      "location": "Sioux City, Iowa, United States",
      "location_code": 1016030,
      "target_url": "https://siouxcitytreeco.com",
      "device": "desktop",
      "language_code": "en",
      "desktop_position": 8,
      "mobile_position": 3,
      "ai_mode_position": 3,
      "maps_position": 3,
      "desktop_url": "https://siouxcitytreeco.com/",
      "mobile_url": "https://siouxcitytreeco.com/",
      "ai_mode_url": "https://siouxcitytreeco.com/",
      "maps_url": "https://siouxcitytreeco.com/",
      "featured_snippet": false,
      "local_pack_position": null,
      "monthly_search_volume": null,
      "net_change": 93,
      "tags": [],
      "last_checked": "2026-05-16T00:10:17.701+00:00",
      "created_at": "2026-03-14T18:24:05.660Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 20,
      "limit": 10,
      "offset": 0,
      "has_more": true
    }
  }
}

Response fields

FieldTypeDescription
desktop_positionnumber or nullCurrent Google Desktop rank
mobile_positionnumber or nullCurrent Google Mobile rank
ai_mode_positionnumber or nullCurrent Google AI Mode rank
maps_positionnumber or nullCurrent Google Maps rank
net_changenumberSum of position changes across all channels. Positive = improved.
featured_snippetbooleanWhether the keyword has a featured snippet
monthly_search_volumenumber or nullEstimated monthly search volume
last_checkedstringWhen positions were last scanned