Skip to main content
GET
Get Search Console top pages
Get your best-performing pages in search results. Visitor counts need analyticsProvider set to the brand’s connected analytics integration (ga, posthog, plausible or snow). Sorting by visitors without it returns 400. Shared parameters and response fields are described on Google Search Traffic.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
required

Team ID

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

Start date (YYYY-MM-DD)

endDate
string

End date (YYYY-MM-DD)

country
string

Country filter

device
string

Device filter

type
string

Search appearance/type filter

limit
string

Maximum rows to return

keywords

Optional keyword filters

analyticsProvider
enum<string>

Connected analytics integration to read page visitors from: ga (Google Analytics), posthog, plausible or snow (Snow Analytics). Without it, rows carry no visitor counts, and sorting by visitors returns 400.

Available options:
ga,
posthog,
plausible,
snow
page
integer

1-based page. Default 1.

pageSize
string

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

sortBy
enum<string>
Available options:
page,
visitors,
clicks,
impressions,
ctr,
position,
clicksChange,
impressionsChange,
ctrChange,
positionChange
sortDir
enum<string>
Available options:
asc,
desc
tab
enum<string>
Available options:
Top Pages,
Growing,
Decaying

Response

200 - application/json

Default Response

items
object[]