Query search performance
gsc_search_analyticsRead-onlyIdempotent
Fetch clicks, impressions, CTR, and position from Google Search Console for any property and date range, grouped by query, page, country, device, or date. Use it to find top queries/pages or track trends.
Instructions
Query Search Console search analytics for a property over a date range: clicks, impressions, CTR, and average position, grouped by the dimensions you pass (query, page, country, device, date). Returns compact rows. Use this for 'what are my top queries / pages' and trend questions. GSC data lags ~2-3 days, so end your range a few days before today.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Search type filter. Defaults to web when omitted. | |
| end_date | Yes | End date, YYYY-MM-DD (Pacific Time, inclusive). | |
| site_url | Yes | The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://example.com/'. | |
| row_limit | No | Max rows to return (default 25, cap 1000). Keep low; rows cost tokens. | |
| dimensions | No | How to group rows. Default ['query']. Combine for breakdowns, e.g. ['page','query']. | |
| start_date | Yes | Start date, YYYY-MM-DD (Pacific Time, inclusive). | |
| dimension_filter_groups | No | Optional filters, e.g. only rows where page contains '/blog/'. Each group's filters are AND-ed. |