L'API Search Analytics prend désormais en charge les données horaires

Mercredi 9 avril 2025

Il y a quelques mois, nous avons annoncé une amélioration dans la façon d'afficher les données sur les performances récentes dans la Search Console. La vue "24 heures" inclut les données des dernières 24 heures disponibles et s'affiche avec un délai de quelques heures seulement. Cette vue peut vous aider à identifier les pages et les requêtes qui fonctionnent bien au cours de cette période récente, et à voir comment les contenus que vous avez récemment publiés sont perçus.

Aujourd'hui, nous ajoutons la prise en charge des données horaires à l'API Search Analytics, en réponse aux demandes de l'écosystème visant à rendre ces données plus accessibles. Par conséquent, nous ajoutons les données horaires à l'API, avec une portée plus large que l'interface produit : tandis que le produit n'affiche les données horaires que pour les 24 heures précédentes, l'API renvoie des données sur une période de 10 jours maximum, avec le détail heure par heure. Cela permettra aux développeurs de créer des solutions permettant d'afficher non seulement les données horaires du dernier jour, mais aussi de comparer le dernier jour au même jour la semaine précédente, ce qui peut être utile pour analyser les tendances des jours de la semaine.

Extraire des données horaires à partir de l'API Search Analytics

Pour rendre les données horaires disponibles dans l'API Search Analytics, nous apportons deux modifications au corps de la requête API :

  • Nouvelle ApiDimension nommée HOUR pour regrouper les réponses par heure.
  • Nouvelle valeur dataState nommée HOURLY_ALL, à utiliser lors du regroupement par HEURE. Cela indique que les données horaires peuvent être partielles.

Dans la section suivante, nous fournissons un exemple de requête API et un exemple de réponse à titre de référence.

Exemple de requête API

{
  "startDate": "2025-04-07",
  "endDate": "2025-04-07",
  "dataState": "HOURLY_ALL",
  "dimensions": [
    "HOUR"
  ]
}

Exemple de réponse de l'API

{
  "rows": [
    {
      "keys": [
        "2025-04-07T00:00:00-07:00"
      ],
      "clicks": 17610,
      "impressions": 1571473,
      "ctr": 0.011206046810858348,
      "position": 10.073871456906991
    },
    {
      "keys": [
        "2025-04-07T01:00:00-07:00"
      ],
      "clicks": 18289,
      "impressions": 1662252,
      "ctr": 0.011002543537321658,
      "position": 9.5440029550272758
    },
    {
      "keys": [
        "2025-04-07T02:00:00-07:00"
      ],
      "clicks": 18548,
      "impressions": 1652038,
      "ctr": 0.011227344649457216,
      "position": 9.81503633693656
    },
    {
      "keys": [
        "2025-04-07T03:00:00-07:00"
      ],
      "clicks": 18931,
      "impressions": 1592716,
      "ctr": 0.01188598595104212,
      "position": 9.4956935197486558
    },
    {
      "keys": [
        "2025-04-07T04:00:00-07:00"
      ],
      "clicks": 20519,
      "impressions": 1595636,
      "ctr": 0.012859449147549943,
      "position": 9.4670100198290843
    },
    …
  ],
  "responseAggregationType": "byProperty"
}

Nous espérons que ces nouvelles données vous aideront à suivre plus efficacement vos contenus récemment publiés, et à prendre les mesures nécessaires en temps voulu. N'hésitez pas à nous faire part de vos commentaires sur cette nouvelle vue ainsi que vos suggestions d'amélioration. Si vous avez des commentaires ou des questions, vous pouvez nous contacter sur LinkedIn ou publier un message dans la communauté Google Search Central.

Publié par Tali Pruss, ingénieure logiciel, et Daniel Waisberg, Expert de la recherche Google