Skip to main content
GET
Top keywords
Get your top keywords with clicks, impressions, CTR, and position. Useful for spotting which keywords are driving the most visibility. scope controls the source:
  • all (default): Search Console queries in Search Console order, with tracked keywords appended. Rows are not re-sorted by position.
  • ranked: Search Console queries only. Returns 404 when Search Console is not connected.
  • tracked: tracked keywords only.
clicks, impressions, and ctr are null for tracked-only rows, which have no Search Console data. search matches the keyword across every keyword, not only the top 50, and returns the matches paginated (page, pageSize, total, totalPages).

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

page
integer
Required range: x >= 1

Case-insensitive text matched against the keyword. Applied before paging, so total counts the matches.

sortBy
enum<string>
Available options:
kw,
pos,
imp,
clicks,
pages,
posDelta
sortDir
enum<string>
Available options:
asc,
desc
category
enum<string>
Available options:
rising,
falling,
new,
lost
teamId
string

Team ID

startDate
string

Start date (YYYY-MM-DD on the team's calendar). days is ignored when a date is sent; ranges over 365 days are clamped. Omit with endDate set for All Time: tracked data starts at the first stored reading, Search Console at its oldest kept day (about 16 months), and no period comparison or change values are returned.

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
device
string

Device filter

type
string

Search type filter

country
string

Country filter

scope
enum<string>

Keyword universe: all (GSC + tracked merged), ranked (GSC only), tracked (tracked only). Defaults to all.

Available options:
all,
ranked,
tracked
limit
integer

Max results

pageSize
string

Rows to return, or all.

includeComparison
string

Include period-over-period comparison

includePages
string

Embed each keyword's ranking page URLs (two extra Search Console queries plus every stored SERP page). Defaults to true; pass false when only the keyword rows are rendered.

Response

Default Response

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