Google Search Analytics API gains hourly break down for past 10 days
Initially we were expecting 8 days of data, but Google gave us 2 more days of hourly data for the performance reports API.
A few weeks ago, Google promised us the 24-hour data in the Search Performance report view would soon come to the Search Console API, with a way to go back 8 days. Well, today this API access is rolling out and Google is giving us 10 days, not 8 days.
What Google said. Google posted on X just now saying, “Today, we’re adding support for hourly data to the Search Analytics API; we heard ecosystem requests to make this data more accessible, loud and clear. The API will return data for up to 10 days with an hourly breakdown.”
Knew it was coming. Today at the Google Search Central Live event in Madrid, Google said it was coming today and here it is:
24-hour data. When Google announced this originally, Google said this “view includes data from the last available 24 hours and will appear with a delay of only a few hours.” Google added:
“The ’24 hours’ view includes hourly granularity in an overtime graph, which is available in all 3 performance reports: Search results, Discover, and Google News. To show you data as soon as possible, Search Console will show data points as soon as we have any data on them, even if we haven’t completed collecting all the data for these points. We will indicate this in the UI using a dotted line.”
Technical details. Google posted some examples over here that say:
In order to make hourly data available in the Search Analytics API, we’re introducing 2 changes to the API request body:
- New
ApiDimension
namedHOUR
for you to group the response by hour. - New
dataState
value namedHOURLY_ALL
, which should be used when grouping by HOUR. This will indicate that hourly data might be partial.
In the following section we provide a sample API request and a sample response for reference.
Export. Google added the ability to export the data in a few file formats back in January. But now you also can access the data via the API, so you can get more real-time data to your internal tools or third-party SEO tools.
Why we care. Being able to access this data outside of the web interface in Google Search Console can be super helpful when trying to debug and discover new insights. Having API access lets you program your own reporting and dashboards to see this data, in almost real time, from Google Search Console. That being said, the more recent data is not always the final data that Google shows, so reviewing the data again may be important, depending on what reports you are trying to generate.
Keep an eye on this data, validate it against the other exports, and see how you can use it to improve your site and content over time.
Try accessing this data via the API today to see what you can do with it.
Related stories