Get performance stats
Clicks, impressions, CTR and average position by query, page, country, device, search appearance, date or hour.
GET https://cotlet.dev/api/v1/google-search-console/performance-stats
Returns the Performance report of a property for a date range, grouped by the dimensions you choose. The hour dimension gives hourly rows for the last 24 hours, the same 24-hour view the report has, or for up to 10 days back; hourly rows include preliminary data for the latest hours. CTR is clicks divided by impressions, and average position is the position of the topmost result from your site. Rows come ordered by clicks, highest first; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| property string required | string | Property as Search Console lists it: sc-domain:example.com for a Domain property, https://example.com/ for a URL-prefix property. |
| range enum | enum | last_24_hours, last_7_days, last_28_days, last_3_months or custom. Default: last_28_days. |
| start_date date | date | First day, with range custom. |
| end_date date | date | Last day, with range custom. |
| dimensions array | array | Any of query, page, country, device, search_appearance, date, hour. |
| filter string | string | Optional filter, e.g. page contains '/guides/' or query contains 'api'. |
| limit integer | integer | 1 to 1000. Default: 100. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/google-search-console/performance-stats?property=property" \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("google-search-console", "get_performance_stats", {"property":"property"}) const result = await cotlet.call('google-search-console', 'get_performance_stats', {"property":"property"}); cotlet call google-search-console get_performance_stats --data '{"property":"property"}' Example response
{
"property": "sc-domain:example.com",
"dimensions": [
"hour"
],
"rows": [
{
"hour": "2026-10-16T08:00:00-07:00",
"clicks": 142,
"impressions": 3980,
"ctr": 0.0357,
"position": 11.4
},
{
"hour": "2026-10-16T09:00:00-07:00",
"clicks": 171,
"impressions": 4410,
"ctr": 0.0388,
"position": 10.9
}
],
"includes_preliminary_data": true,
"next_cursor": null
}