---
title: "Top Search Console queries (Growth+)"
method: GET
path: "/search_console/queries"
tags: ["Search Console"]
---

# Top Search Console queries (Growth+)

`GET /search_console/queries`

Top Google Search Console search queries over a date range, ranked by impressions/clicks/ctr/position, paginated. Requires a connected Search Console property (Growth+). Returns ERR_SEARCH_CONSOLE_ACCESS_REVOKED (403) when Google has revoked the connection's access (reconnect the property), and ERR_SEARCH_CONSOLE_UPSTREAM (503, with a Retry-After header) when Google Search Console is unavailable or over quota. total is the number of distinct keys Google returned for the range (the Search Analytics API caps one query at 25,000 rows); truncated: true flags a capped response, and sort=ctr or sort=position ranks within that returned set.

## Query parameters

- `project_id` integer, required
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `sort` 'impressions' | 'clicks' | 'ctr' | 'position'
- `page` integer
- `per_page` integer
- `output` 'flat' | 'csv'

## Response `200`

Top queries

## Other responses

- `403` — Plan below Growth (ERR_PLAN_REQUIRED), or Google revoked the project's Search Console access (ERR_SEARCH_CONSOLE_ACCESS_REVOKED): reconnect the property
- `404` — Resource not found
- `503` — Upstream provider unavailable, retry after the number of seconds in the Retry-After header

## Changes

- **2026-09-03** `0b25c80a6920` — 1 info
  - added the non-success response with the status `503`
- **2026-07-27** `c01e99c81c66` — 1 info
  - added the new optional `query` request parameter `output`

[Change history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/search_console/queries/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) · [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmpulse/llm-pulse-api/revisions/a3e61e246f23/schema)