ScrepyDocs

List Rank Tracker keywords

Returns a lightweight cursor-paginated list. Use the analysis endpoints for history and stored organic results.

GET/projects/{project_uid}/rank-tracker/keywords

Returns a lightweight cursor-paginated list. Use the analysis endpoints for history and stored organic results.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a REST API key in Settings > Connected Apps. MCP credentials do not authenticate this API.

In: header

Path Parameters

project_uid*string

Accessible project UID. Discover it with GET /projects; do not guess it.

Match^[a-z0-9]{10}$

Query Parameters

device?string
Default"mobile"

Value in

  • "mobile"
  • "desktop"
search?string
Lengthlength <= 255
segment_id?integer

Project-scoped numeric segment ID. Cannot be combined with unmatched=true.

Range1 <= value
unmatched?boolean

Return only keywords not matched by any saved segment. Cannot be combined with segment_id.

Defaultfalse
sort?string
Default"position"

Value in

  • "keyword"
  • "market"
  • "position"
  • "last_analyzed"
direction?string
Default"asc"

Value in

  • "asc"
  • "desc"
limit?integer

Maximum records to return. Defaults to 50.

Range1 <= value <= 100
Default50
cursor?string

Opaque cursor returned by the prior response. Do not construct or alter it.

Lengthlength <= 512

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/string/rank-tracker/keywords"
{  "data": [    {      "id": 1,      "keyword": "string",      "device": "mobile",      "country_code": "string",      "language_code": "string",      "location": "string",      "last_position": 0,      "best_position": 0,      "last_result_url": "http://example.com",      "last_analyzed_at": "2019-08-24T14:15:22Z",      "next_analyze_at": "2019-08-24T14:15:22Z",      "status": "pending",      "change_position": 0,      "owned_results_count": 0,      "serp_features": {        "property1": true,        "property2": true      },      "message": "string",      "competitors": [        {          "id": 0,          "name": "string",          "domain": "string",          "position": 0        }      ]    }  ],  "links": {    "next": "http://example.com"  },  "meta": {    "per_page": 0,    "next_cursor": "string",    "previous_cursor": "string",    "has_more": true  }}

Get the Rank Tracker overview

Returns summary metrics, a 30-day visibility series, position distribution, plan usage, and update frequency.

Add Rank Tracker keywords

Adds at most 100 unique keywords. `both` creates two tracked records per keyword and consumes two units. Initial analysis is scheduled automatically; manual reanalysis is not available.