Skip to main content
GET
Get Search Console search queries
Get the search queries driving traffic to your site, sorted by clicks. 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

includePages
string

Embed each row's ranking page URLs and their metrics inside the row (multiplies the payload by the number of URLs per row). Defaults to false; the pages count is always returned.

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:
query,
clicks,
impressions,
ctr,
position,
pages,
clicksChange,
impressionsChange,
ctrChange,
positionChange
sortDir
enum<string>
Available options:
asc,
desc
tab
enum<string>
Available options:
Top,
Growing,
Decaying,
Long Tail,
Questions
positionBand
enum<string>
Available options:
top3,
4-10,
11-20,
21-49,
50-100,
100+

Response

200 - application/json

Default Response

items
object[]
total
number
returned
number
summary
object
coverage
object