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
    }
  }
}
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