Query performance over time
get_query_performanceUse this when the user asks how one search query performed day by day. Daily performance for a single search query, optionally restricted to one landing page. Useful for tracking position changes after on-page edits. Not for a ranking of queries: use query_top_queries. query (and pageUrl) must match exactly. Rows run by date, oldest first; days without impressions are absent, not zero. ctr is a 0-100 percentage. Served from the ClickHouse warehouse when available, otherwise the live Search Console API (see dataSource). Date range is optional: omit startDate/endDate to analyze the last 28 settled days (data lags ~2-3 days).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"siteUrl": "<siteUrl>",
"query": "<query>"
},
"name": "get_query_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| endDate | No | Optional. Window end as YYYY-MM-DD (e.g. 2026-05-31). You do NOT need to know today's date or the latest available date: omit this and the server uses the latest settled Search Console date (data lags ~2-3 days behind today). Never pass null or the string "null". | |
| pageUrl | No | ||
| siteUrl | Yes | ||
| startDate | No | Optional. Window start as YYYY-MM-DD (e.g. 2026-05-03). You do NOT need to know today's date. Omit BOTH startDate and endDate to analyze the last 28 settled days automatically (Search Console data lags ~2-3 days). Never pass null or the string "null". | |
| searchType | No | Search type: web (default), image, video, news (the News tab), discover, googleNews (news.google.com), webMultimodal (Google Lens, Circle to Search and image uploads; data from 2026-02-20; not part of all), or all (web + image + video + news + discover combined, position impression-weighted, like the app's "All" filter). Discover, googleNews and webMultimodal carry no query dimension, so query-level results for them are empty; Discover and googleNews also carry no position: it reads null, not 0. | web |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| daily | No | ||
| query | No | ||
| range | No | ||
| thenBy | No | ||
| listKey | No | Name of the top-level field that holds the rows sortedBy describes. | |
| pageUrl | No | ||
| siteUrl | No | ||
| warning | No | ||
| nextStep | No | ||
| ordering | No | ||
| sortedBy | No | ||
| sortOrder | No | ||
| thenOrder | No | ||
| dataSource | No | ||
| partialDays | No | ||
| dataMaturity | No | ||
| emptyBecause | No | ||
| methodLimits | No | ||
| settledThrough | No | ||
| warehouseLatestDate | No |