Skip to main content
GET
Tracked keywords table
The tracked-keywords table from the dashboard. Keyword locations are grouped by keyword; each page returns whole groups plus a summary with tracked, untracked, clustered and running counts.
  • Returns 25 keyword groups per page unless pageSize is set (all returns every group).
  • Filter with search (keyword text) and country (ISO2).
  • Sort with sortBy (kw, country, pos, rankedPages, delta) and sortDir.
  • The window defaults to the last 30 days (set startDate/endDate or days); position change compares it with the period before it.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

startDate
string

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

endDate
string

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

days
integer
default:30

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

Required range: x >= 1
includeInactive
boolean

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

Keyword text to match.

country
string

Country (ISO2) to match.

sortBy
enum<string>
Available options:
kw,
country,
pos,
rankedPages,
delta
sortDir
enum<string>
Available options:
asc,
desc
page
integer

1-based page. Default 1.

pageSize
string

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

Response

Default Response

items
object[]
required
page
integer
pageSize
integer
total
integer
totalPages
integer
summary
object