Analytics

Query Google Search Console search analytics

Changed on

Clicks, impressions, CTR and average position from Google Search for a connected Search Console site, through Google's searchAnalytics.query.

Group by any of date, hour, query, page, country, device, searchAppearance and brandedClassification, and filter with Google's own filter groups. With no dimensions you get one row with the site's totals.

Branded queries

brandedClassification splits searches into BRANDED and NON_BRANDED. Google has it from February 21, 2026, and only for sites with enough search volume. As a filter it takes equals only and cannot be combined with a query filter.

Dates

Dates are YYYY-MM-DD in Pacific time. toDate defaults to yesterday and fromDate to 27 days before toDate, the window every report takes. Unknown fields answer 400. Google keeps 16 months, and the last two or three days are still filling in unless you pass dataState: all.

Caching and quota

Identical requests on the same site are cached for 10 minutes. Google limits each site to 1,200 queries a minute; past it the request returns 429.

post/v1/analytics/googlesearchconsole/search-analytics

Request

  • Base URL
    https://zernio.com/api
  • Auth
    HTTP bearer

Request body

accountIdstring required

Zernio account ID of the Google Search Console connection.

fromDatestring date
toDatestring date
dimensionsstring[]
type'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews' | 'webMultimodal'

Which Google surface to read. Defaults to web. webMultimodal is Google Lens, Circle to Search and image uploads.

aggregationType'auto' | 'byPage' | 'byProperty' | 'byNewsShowcasePanel'

byNewsShowcasePanel needs a NEWS_SHOWCASE searchAppearance filter and type discover or googleNews.

rowLimitinteger

Defaults to 1000.

startRowinteger

Row offset for paging past rowLimit.

dataState'final' | 'all' | 'hourly_all'

final (default) leaves out the last two or three days; all includes them while Google is still filling them in; hourly_all is required with the hour dimension.

Example request

{
  "fromDate": "2026-10-01",
  "toDate": "2026-10-31",
  "dimensionFilterGroups": [
    {
      "filterLists": [
        {
          "expressions": [
            "usa",
            "gbr",
            "can"
          ]
        }
      ]
    }
  ]
}

Response

Rows from Google, ordered by clicks

Example response

{
  "data": [
    {
      "keys": [
        "social media api"
      ],
      "clicks": 412,
      "impressions": 9875,
      "ctr": 0.0417,
      "position": 6.3
    }
  ],
  "meta": {
    "siteUrl": "sc-domain:acme.com",
    "aggregationType": "byProperty"
  }
}

Changes