SNsnowseo
Rank Tracking

Tracked keywords table

Changed on

The dashboard's tracked-keywords table: one page of keyword locations grouped by keyword, with position history, the average position and change over the window, and stored SERP result history. Filter with search or country, sort with sortBy, and read summary for tracked/untracked/clustered/running counts. Returns 25 keyword groups per page unless pageSize is set. The window defaults to the last 30 days and is compared with the period before it.

get/v3/rank-tracking/keywords/table

Request

Query parameters

teamIdstring

Team ID

startDatestring

Start date (YYYY-MM-DD on the team's calendar). days is ignored when a date is sent.

endDatestring

End date (YYYY-MM-DD on the team's calendar). days is ignored when a date is sent.

daysinteger

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 30.

includeInactiveboolean

When true, also returns soft-untracked (active=false) keywords so the UI can offer re-tracking. Defaults to false (active only).

searchstring

Keyword text to match.

countrystring

Country (ISO2) to match.

sortBy'kw' | 'country' | 'pos' | 'rankedPages' | 'delta'
sortDir'asc' | 'desc'
pageinteger

1-based page. Default 1.

pageSizestring

Rows per page (max 1000), or 'all'. Every response reports total and totalPages.

Response

Default Response

pageinteger
pageSizeinteger
totalinteger
totalPagesinteger
summaryobject

Changes