Stay organized with collections
Save and categorize content based on your preferences.
Wednesday, April 9, 2025
A few months ago, we announced an improved way to view
recent performance data in Search Console.
The "24 hours" view includes data from the last available 24 hours and appears with a delay of
only a few hours. This view can help you find information about which pages and queries are
performing in this recent timeframe and how content you recently published is picking up.
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. As a result, we're
adding hourly data to the API and with a wider scope than the product interface: while the product
displays hourly data only for the past 24 hours, the API will return data for up to 10 days with
an hourly breakdown. This will allow developers to create solutions to show not only hourly data
for the latest day, but also to compare the most recent day to the same day in the previous week,
which can be useful when analyzing patterns for the days of the week.
How to pull hourly data from the Search Analytics API
In order to make hourly data available in the Search Analytics API, we're introducing 2 changes to
the API request body:
New ApiDimension named HOUR for you to group the response by
hour.
New dataState value named HOURLY_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.
We hope that this new data will help you better monitor your recently published content in a more
effective way and help you take action in a timely manner. We would love to hear your thoughts on
how this new view works for you and to hear any suggestions on how to make it even better. If you
have any feedback, questions, or comments, you can find us on
LinkedIn
or post in the Google Search Central Community.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],[],[],[],null,["# The Search Analytics API now supports hourly data\n\nWednesday, April 9, 2025\n\n\nA few months ago, we announced an improved way to view\n[recent performance data in Search Console](/search/blog/2024/12/recent-data-search-console).\nThe \"24 hours\" view includes data from the last available 24 hours and appears with a delay of\nonly a few hours. This view can help you find information about which pages and queries are\nperforming in this recent timeframe and how content you recently published is picking up.\n\n\nToday, we're adding support for hourly data to the\n[Search Analytics API](/webmaster-tools/v1/searchanalytics/query),\nwe heard ecosystem requests to make this data more accessible loud and clear. As a result, we're\nadding hourly data to the API and with a wider scope than the product interface: while the product\ndisplays hourly data only for the past 24 hours, the API will return data for up to 10 days with\nan hourly breakdown. This will allow developers to create solutions to show not only hourly data\nfor the latest day, but also to compare the most recent day to the same day in the previous week,\nwhich can be useful when analyzing patterns for the days of the week.\n\nHow to pull hourly data from the Search Analytics API\n-----------------------------------------------------\n\n\nIn order to make hourly data available in the Search Analytics API, we're introducing 2 changes to\nthe [API request body](/webmaster-tools/v1/searchanalytics/query#request-body):\n\n- New `ApiDimension` named `HOUR` for you to group the response by hour.\n- New `dataState` value named `HOURLY_ALL`, which should be used when grouping by HOUR. This will indicate that hourly data might be partial.\n\n\nIn the following section we provide a sample API request and a sample response for reference.\n\n### Sample API request\n\n```scdoc\n{\n \"startDate\": \"2025-04-07\",\n \"endDate\": \"2025-04-07\",\n \"dataState\": \"HOURLY_ALL\",\n \"dimensions\": [\n \"HOUR\"\n ]\n}\n```\n\n### Sample API response\n\n```verilog\n{\n \"rows\": [\n {\n \"keys\": [\n \"2025-04-07T00:00:00-07:00\"\n ],\n \"clicks\": 17610,\n \"impressions\": 1571473,\n \"ctr\": 0.011206046810858348,\n \"position\": 10.073871456906991\n },\n {\n \"keys\": [\n \"2025-04-07T01:00:00-07:00\"\n ],\n \"clicks\": 18289,\n \"impressions\": 1662252,\n \"ctr\": 0.011002543537321658,\n \"position\": 9.5440029550272758\n },\n {\n \"keys\": [\n \"2025-04-07T02:00:00-07:00\"\n ],\n \"clicks\": 18548,\n \"impressions\": 1652038,\n \"ctr\": 0.011227344649457216,\n \"position\": 9.81503633693656\n },\n {\n \"keys\": [\n \"2025-04-07T03:00:00-07:00\"\n ],\n \"clicks\": 18931,\n \"impressions\": 1592716,\n \"ctr\": 0.01188598595104212,\n \"position\": 9.4956935197486558\n },\n {\n \"keys\": [\n \"2025-04-07T04:00:00-07:00\"\n ],\n \"clicks\": 20519,\n \"impressions\": 1595636,\n \"ctr\": 0.012859449147549943,\n \"position\": 9.4670100198290843\n },\n ...\n ],\n \"responseAggregationType\": \"byProperty\"\n}\n```\n\n\nWe hope that this new data will help you better monitor your recently published content in a more\neffective way and help you take action in a timely manner. We would love to hear your thoughts on\nhow this new view works for you and to hear any suggestions on how to make it even better. If you\nhave any feedback, questions, or comments, you can find us on\n[LinkedIn](https://www.linkedin.com/showcase/googlesearchcentral/)\nor post in the [Google Search Central Community](https://support.google.com/webmasters/threads?thread_filter=(category:search_console)).\n\n\nPosted by [Tali Pruss](https://www.linkedin.com/in/talipruss/),\nSoftware Engineer, and [Daniel Waisberg](/search/blog/authors/daniel-waisberg), Search\nAdvocate"]]