Skip to main content
GET
List pages with their search performance
Get every page in the brand’s inventory merged with its Search Console clicks, impressions, CTR, average position and keyword count for the selected window. Pages with no search traffic are included so they stay findable. Rows carry visitors and visitorsChange only when analyticsProvider names the brand’s connected analytics integration (ga, posthog, plausible or snow). Sorting by visitors or visitorsChange without it returns 400.

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).

endDate
string

End date (YYYY-MM-DD on the team's calendar). A start with no end runs to today; an end with no start means All Time.

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

ISO-3 country code to filter Search Console rows by.

device
string

Device filter: desktop, mobile or tablet.

type
string

Search type: web, image, video or news.

Filter to pages whose URL or title contains this text.

limit

Page size, or all for explicit bulk selection resolution.

Required range: 1 <= x <= 5000
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
offset
integer

Rows to skip.

sortKey
enum<string>

Column to sort on. Defaults to clicks.

Available options:
clicks,
impressions,
ctr,
position,
keywords,
url,
auditScore,
aiCitations,
clicksChange,
keywordsChange,
positionChange,
visitors,
visitorsChange
sortDir
enum<string>

Sort direction. Defaults to desc.

Available options:
asc,
desc

Response

200 - application/json

Default Response

items
object[]
required
total
integer
required
connected
boolean
startDate
string | null
endDate
string | null