Die Search Analytics API unterstützt jetzt stündliche Daten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mittwoch, 9. April 2025
Vor einigen Monaten haben wir eine verbesserte Möglichkeit angekündigt, aktuelle Leistungsdaten in der Search Console aufzurufen.
Die Ansicht „24 Stunden“ enthält Daten aus den letzten verfügbaren 24 Stunden und wird mit einer Verzögerung von nur wenigen Stunden angezeigt. In dieser Ansicht finden Sie Informationen dazu, welche Seiten und Suchanfragen im letzten Zeitraum gut abgeschnitten haben und wie sich die Leistung Ihrer kürzlich veröffentlichten Inhalte entwickelt hat.
Ab heute wird die Search Analytics API um die Unterstützung stündlicher Daten erweitert. Wir haben viele Anfragen erhalten, diese Daten leichter zugänglich zu machen. Deshalb fügen wir der API stündliche Daten hinzu, die einen größeren Umfang als die Produktoberfläche haben: Während in der Produktoberfläche nur stündliche Daten für die letzten 24 Stunden angezeigt werden, gibt die API Daten für bis zu 10 Tage mit einer stündlichen Aufschlüsselung zurück. So können Entwickler Lösungen erstellen, mit denen nicht nur stündliche Daten für den letzten Tag angezeigt werden, sondern auch der letzte Tag mit demselben Tag in der Vorwoche verglichen werden kann. Das kann bei der Analyse von Mustern für die Wochentage hilfreich sein.
Stündliche Daten aus der Search Analytics API abrufen
Damit stündliche Daten in der Search Analytics API verfügbar sind, nehmen wir zwei Änderungen am API-Anfragetext vor:
Neue ApiDimension mit dem Namen HOUR, mit der Sie die Antworten nach Stunde gruppieren können.
Neuer dataState-Wert namens HOURLY_ALL, der bei der Gruppierung nach STUNDE verwendet werden sollte. Dies bedeutet, dass die stündlichen Daten möglicherweise unvollständig sind.
Im folgenden Abschnitt findest du eine Beispiel-API-Anfrage und eine Beispielantwort.
Wir hoffen, dass ihr mit diesen neuen Daten eure kürzlich veröffentlichten Inhalte besser und effektiver im Blick behalten und gegebenenfalls zeitnah Maßnahmen ergreifen könnt. Wir würden gern wissen, wie diese neue Ansicht bei euch funktioniert und welche Vorschläge ihr dazu habt, wie sie sich noch verbessern lässt. Wenn ihr Feedback, Fragen oder Kommentare habt, könnt ihr euch auf LinkedIn an uns wenden oder einen Beitrag in der Google Search Central-Community posten.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","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"]]
