---
title: "Get Search Console search queries"
method: GET
path: "/v3/integrations/gsc/website-traffic/search-queries"
tags: ["Google Search Console"]
---

# Get Search Console search queries

`GET /v3/integrations/gsc/website-traffic/search-queries`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/integrations/gsc/website-traffic/search-queries`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns search queries with server-side pagination, search, tab and position-band filters, sorting and period changes. pageSize defaults to 50; use all for an explicit full export. summary describes the complete date window independently of table filters. coverage reports the window served by Google.

## Query parameters

- `teamId` string, required
- `days` union
  - string
  - integer
- `startDate` string
- `endDate` string
- `country` string
- `device` string
- `type` string
- `limit` string
- `includePages` string
- `page` integer
- `pageSize` string
- `search` string
- `sortBy` 'query' | 'clicks' | 'impressions' | 'ctr' | 'position' | 'pages' | 'clicksChange' | 'impressionsChange' | 'ctrChange' | 'positionChange'
- `sortDir` 'asc' | 'desc'
- `tab` 'Top' | 'Growing' | 'Decaying' | 'Long Tail' | 'Questions'
- `positionBand` 'top3' | '4-10' | '11-20' | '21-49' | '50-100' | '100+'

## Response `200`

Default Response

- object
  - `items` object[]
    - `query` string
    - `pages` number
    - `rankedPages` object[]
    - `clicks` number
    - `impressions` number
    - `ctr` number
    - `position` number
    - `clicksChange` number
    - `impressionsChange` number
    - `ctrChange` number
    - `positionChange` number
  - `total` number
  - `returned` number
  - `summary` object
    - `previousTotal` number
    - `isCapped` boolean
    - `previousIsCapped` boolean
    - `top3` number
    - `range4to10` number
    - `range11to20` number
    - `range21to49` number
    - `range50to100` number
    - `range100plus` number
  - `coverage` object
    - `startDate` string
    - `endDate` string
    - `latestAvailableDate` string, nullable
    - `firstProvisionalDate` string, nullable
    - `includesProvisional` boolean
    - `isEstimated` boolean
    - `timeZone` string

## Changes

- **2026-10-06** `7ede4ba45814`: 7 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageSize`
  - added the new optional `query` request parameter `positionBand`
  - added the new optional `query` request parameter `search`
  - …3 more
- **2026-10-03** `3976341798f4`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-08-26** `c44f51a92d95`: 1 info
  - added the new optional `query` request parameter `includePages`

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/integrations/gsc/website-traffic/search-queries/get.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) - [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/ac69ae8943d7?raw)