> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Search Traffic

> Pull your Google Search Console data — clicks, impressions, keywords, pages, and more.

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.

<Note>
  You need a **Google Search Console** integration connected to your team. You can connect it from **Settings → Integrations → SEO & AI Tools**.
</Note>

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.

***

## Page Performance Changes

`GET /integrations/gsc/website-traffic/page-changes`

See which pages gained or lost clicks, impressions, CTR, or position between periods.

***

## Pages for a Keyword

`GET /integrations/gsc/website-traffic/pages-for-keyword`

See which of your pages rank for a specific search query. Pass the `keyword` query parameter.


## OpenAPI

````yaml GET /v3/integrations/gsc/website-traffic/stats
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/integrations/gsc/website-traffic/stats:
    get:
      tags:
        - GSC
      summary: Get GSC traffic stats
      description: >-
        Returns Google Search Console traffic stats (clicks, impressions, CTR,
        position) with trends.
      operationId: getGscTraffic
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: false
          description: Team ID
        - schema:
            type: string
          in: query
          name: startDate
          required: false
          description: ISO start date (YYYY-MM-DD)
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: ISO end date (YYYY-MM-DD)
        - schema:
            type: integer
          in: query
          name: days
          required: false
          description: Number of days to look back
        - schema:
            type: string
          in: query
          name: device
          required: false
          description: Device filter
        - schema:
            type: string
          in: query
          name: type
          required: false
          description: Search type filter
        - schema:
            type: string
          in: query
          name: country
          required: false
          description: Country filter
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalClicks:
                    type: number
                  totalImpressions:
                    type: number
                  averageCTR:
                    type: number
                  averagePosition:
                    type: number
                  clicksTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  impressionsTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  ctrTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  positionTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  prevClicksTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  prevImpressionsTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  prevCtrTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  prevPositionTrend:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  clicksChange:
                    type: object
                    additionalProperties: true
                  impressionsChange:
                    type: object
                    additionalProperties: true
                  ctrChange:
                    type: object
                    additionalProperties: true
                  positionChange:
                    type: object
                    additionalProperties: true
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string

````