Search Console performance report
gsc_search_analyticsRetrieve Google Search Console search performance metrics—clicks, impressions, CTR, and position—grouped by query, page, country, device, date, or search appearance; supports filters and pagination.
Instructions
Search performance (clicks, impressions, CTR, position) grouped by query, page, country, device, date or searchAppearance, with filters and pagination.
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>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "gsc_search_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | Yes | End: YYYY-MM-DD, today, yesterday or NdaysAgo (data lags 2-3 days). | |
| filters | No | All filters are AND-ed. | |
| siteUrl | Yes | Search Console property, e.g. 'sc-domain:example.com' (see gsc_list_sites). | |
| rowLimit | No | ||
| startRow | No | Pagination offset. | |
| dataState | No | 'all' includes fresh, not yet final, data. 'hourly_all' is required for (and only works with) the 'hour' dimension, which returns up to the last 10 days broken down by hour: use it to confirm within hours that a republished page or a fixed canonical is being picked up, instead of waiting out the usual 2-3 day lag. | final |
| startDate | Yes | Start: YYYY-MM-DD, today, yesterday or NdaysAgo (data lags 2-3 days). | |
| dimensions | No | Group-by; [] for totals, ['date'] for a trend. | |
| searchType | No | web | |
| aggregationType | No |