Skip to main content
GET
/
v3
/
integrations
/
gsc
/
website-traffic
/
stats
Get GSC traffic stats
curl --request GET \
  --url https://api.snowseo.com/v3/integrations/gsc/website-traffic/stats \
  --header 'Authorization: Bearer <token>'
{
  "totalClicks": 123,
  "totalImpressions": 123,
  "averageCTR": 123,
  "averagePosition": 123,
  "clicksTrend": [
    {}
  ],
  "impressionsTrend": [
    {}
  ],
  "ctrTrend": [
    {}
  ],
  "positionTrend": [
    {}
  ],
  "prevClicksTrend": [
    {}
  ],
  "prevImpressionsTrend": [
    {}
  ],
  "prevCtrTrend": [
    {}
  ],
  "prevPositionTrend": [
    {}
  ],
  "clicksChange": {},
  "impressionsChange": {},
  "ctrChange": {},
  "positionChange": {}
}
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.
The prev*Trend arrays (e.g. prevClicksTrend) contain the previous period’s data for comparison. *Change objects give you the percentage change and whether it’s a positive movement.

​
Search Queries

GET /integrations/gsc/website-traffic/search-queries Get the search queries driving traffic to your site, sorted by clicks.

​
Top Pages

GET /integrations/gsc/website-traffic/top-pages Get your best-performing pages in search results.

​
Traffic by Country

GET /integrations/gsc/website-traffic/countries See how your search traffic breaks down by country.

​
Traffic by Device

GET /integrations/gsc/website-traffic/devices See how your search traffic breaks down by device type.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
teamId
string

Team ID

​
startDate
string

ISO start date (YYYY-MM-DD)

​
endDate
string

ISO end date (YYYY-MM-DD)

​
days
integer

Number of days to look back

​
device
string

Device filter

​
type
string

Search type filter

​
country
string

Country filter

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