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

read

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

Parameters: get_performance_stats
NameTypeDescription
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
curl "https://cotlet.dev/api/v1/google-search-console/performance-stats?property=property" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("google-search-console", "get_performance_stats", {"property":"property"})
Node.js
const result = await cotlet.call('google-search-console', 'get_performance_stats', {"property":"property"});
CLI
cotlet call google-search-console get_performance_stats --data '{"property":"property"}'

Example response

JSON

{
  "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
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.