Skip to main content
GET
Get GSC traffic stats
Get your organic search performance data directly from Google Search Console. These endpoints give you the same data that powers the Traffic dashboard’s Google tab - clicks, impressions, CTR, average position, top queries, and top pages.
You need a Google Search Console integration connected to your team. You can connect it from Settings → Integrations → SEO & AI Tools.
Send startDate and endDate or days; with neither you get the last 30 days. Search Console data lags 2-3 days, so a window ending today is clamped to Google’s newest day. See Date Windows. The prev*Trend arrays (e.g. prevClicksTrend) contain the previous period’s data for comparison, but are empty unless you pass includePrevious=true. *Change objects give you the percentage change and whether it’s a positive movement; for position, positionChange is the absolute difference in position and isPositive carries the direction.

More endpoints

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

startDate
string

ISO start date (YYYY-MM-DD)

endDate
string

ISO end date (YYYY-MM-DD)

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

includePrevious
string

Include previous-period comparison values alongside each data point (roughly doubles the time-series payload). Defaults to false.

Response

Default Response

totalClicks
number
totalImpressions
number
averageCTR
number
averagePosition
number
clicksTrend
object[]
impressionsTrend
object[]
ctrTrend
object[]
positionTrend
object[]
prevClicksTrend
object[]
prevImpressionsTrend
object[]
prevCtrTrend
object[]
prevPositionTrend
object[]
clicksChange
object
impressionsChange
object
ctrChange
object
positionChange
object
coverage
object