# gsc_query_search_analytics

> Query Google Search Console Search Analytics. One of 18 Search Console tools on the Get MCP Ads MCP gateway.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Search Console](https://www.getmcpads.com/docs/sources/search-console)

Query Google Search Console Search Analytics. Returns clicks, impressions, CTR, and average position for queries, pages, countries, devices, dates, and search appearances.
Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for available fields and rules.

|  |  |
| --- | --- |
| Source | [Search Console](https://www.getmcpads.com/docs/sources/search-console) |
| Kind | Read |
| Discovery | Announced in the tool list |
| Account parameter | `siteUrl` |
| Endpoint | https://mcp.getmcpads.com/search-console/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `siteUrl` | string | Optional | Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted. |
| `metrics` | array | Optional | Native: clicks, impressions, ctr, position. Calculated: ctrOpportunity, clicksPerImpression, impressionShare, clickShare. |
| `dimensions` | array | Optional | Up to 5 dimensions: query, page, country, device, date, searchAppearance. |
| `filters` | array | Optional |  |
| `searchType` | string | Optional | One of: `web`, `image`, `video`, `news`, `discover`, `googleNews`. Default: `"web"`. |
| `datePreset` | string | Optional | One of: `today`, `yesterday`, `last7days`, `last28days`, `last3months`, `last6months`, `last12months`, `last16months`. Default: `"last28days"`. |
| `dateRange` | object | Optional |  |
| `orderBy` | string | Optional | One of: `clicks`, `impressions`, `ctr`, `position`, `ctrOpportunity`, `clicksPerImpression`, `impressionShare`, `clickShare`. Default: `"clicks"`. |
| `orderDirection` | string | Optional | One of: `ASC`, `DESC`. Default: `"DESC"`. |
| `limit` | integer | Optional | Default: `1000`. |
| `startRow` | integer | Optional | Optional 0-based row offset for explicit pagination. |
| `autoPaginate` | boolean | Optional | When true, omit rowLimit so the GSC client auto-paginates until exhaustion. Default: `false`. |

## Calling it

Directly, since it is announced

```json
{
  "name": "gsc_query_search_analytics",
  "arguments": {}
}
```

- [Search Console metrics](https://www.getmcpads.com/docs/sources/search-console/metrics): What you can ask for.
- [Search Console dimensions](https://www.getmcpads.com/docs/sources/search-console/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/search-console/tools/gsc_query_search_analytics
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.