Query shape trend over time
get_query_shape_trendRead-only
Tracks how much of a property's search traffic comes from AI-shaped queries over time: the trend chart on the app's Query Analysis report. Returns one row per month (or week) with clicks and impressions split into AI-shaped (reply artefacts, pivot follow-ups, conversational questions) versus conventional keywords, plus the AI-shaped share of each metric. Use this to answer "are AI Overviews / AI Mode queries growing on this site?", which no single-period report can show. Defaults to the last 12 complete months. Served from the GSC Wizard ClickHouse warehouse when available (longer history, no sampling), otherwise the live Search Console API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | How many complete months to cover, ending with last month (1-16; Search Console keeps ~16 months). | |
| endDate | No | Optional. Window end as YYYY-MM-DD. Provide BOTH startDate and endDate to override the default window, or omit both to use the last `months` complete months. Never pass null or "null". | |
| siteUrl | Yes | ||
| startDate | No | Optional. Window start as YYYY-MM-DD. Provide BOTH startDate and endDate to override the default window, or omit both to use the last `months` complete months. Never pass null or "null". | |
| searchType | No | web | |
| granularity | No | month |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| range | No | ||
| periods | No | ||
| siteUrl | No | ||
| shapeNote | No | ||
| truncated | No | ||
| dataSource | No | ||
| granularity | No | ||
| dataMaturity | No | ||
| settledThrough | No | ||
| truncationNote | No | ||
| warehouseLatestDate | No |