Query Google Search Console search analytics
Changed onClicks, 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.
Request
- Base URLhttps://zernio.com/api
- AuthHTTP bearer
Request body
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
- info
endpoint added
- info