A API Search Analytics agora oferece suporte a dados por hora

Quarta-feira, 9 de abril de 2025

Há alguns meses, anunciamos uma maneira aprimorada de conferir dados de performance recentes no Search Console. Essa visualização inclui dados das últimas 24 horas disponíveis e aparece com um atraso de apenas algumas horas. Ela pode ajudar você a encontrar informações sobre o desempenho das páginas e consultas nesse período e do conteúdo publicado recentemente.

Hoje, estamos adicionando suporte aos dados por hora à API Search Analytics. Recebemos pedidos no ecossistema para tornar esses dados mais acessíveis. Por isso, vamos incluir os dados por hora na API, com um escopo mais amplo do que a interface do produto: enquanto o produto mostra dados por hora apenas das últimas 24 horas, a API vai retornar dados de até 10 dias com detalhamento por hora. Assim, os desenvolvedores podem criar soluções para mostrar dados por hora do último dia e também fazer uma comparação com o mesmo dia da semana anterior, o que pode ser útil ao analisar padrões dos dias da semana.

Como extrair dados por hora da API Search Analytics

Para disponibilizar dados por hora na API Search Analytics, fizemos duas mudanças no corpo da solicitação da API:

  • Nova ApiDimension chamada HOUR para agrupar a resposta por hora.
  • Novo valor dataState chamado HOURLY_ALL, que precisa ser usado ao agrupar por HORA. Isso indica que os dados por hora podem ser parciais.

Na próxima seção, vamos dar um exemplo de solicitação e de resposta da API para referência.

Exemplo de solicitação da API

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

Exemplo de resposta da 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"
}

Esperamos que esses novos dados ajudem a monitorar o conteúdo recém-publicado de maneira mais eficiente e a tomar medidas em tempo hábil. Queremos saber sua opinião sobre o funcionamento dessa nova visualização e receber sugestões para melhorar ainda mais. Se você tiver feedback, dúvidas ou comentários, entre em contato com nossa equipe pelo LinkedIn ou poste na Comunidade da Central da Pesquisa Google.

Postado por Tali Pruss, Engenheira de software, e Daniel Waisberg, Mediador da Pesquisa