La API de análisis de búsqueda ahora admite datos por hora para Search Console

Hoy añaden compatibilidad con datos por hora a la API de Search Analytics . Hemos escuchado las peticiones del ecosistema para que estos datos sean más accesibles, claros y concisos. Por ello, añadimos datos por hora a la API con un alcance más amplio que la interfaz del producto: mientras que el producto muestra datos por hora solo de las últimas 24 horas, la API devolverá datos de hasta 10 días con un desglose por hora. Esto permitirá a los desarrolladores crear soluciones que muestren no solo los datos por hora del último día, sino también que comparen el día más reciente con el mismo día de la semana anterior, lo que puede ser útil al analizar patrones de los días de la semana.

¿Cómo extraer datos por hora de la API de Search Analytics?

Para que los datos por hora estén disponibles en la API de Search Analytics, estamos introduciendo dos cambios en el cuerpo de la solicitud de la API :

• Nuevo ApiDimensionnombre HOURpara que puedas agrupar la respuesta por hora.
• Nuevo dataStatevalor llamado HOURLY_ALL, que debe usarse al agrupar por HORA. Esto indicará que los datos horarios podrían ser parciales.

En la siguiente sección proporcionamos una solicitud de API de muestra y una respuesta de muestra como referencia.

Solicitud de API de muestra

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

Respuesta de API de muestra

{
  "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 estos nuevos datos te ayuden a supervisar mejor tu contenido publicado recientemente de forma más eficaz y a tomar medidas oportunas. Google quiere conocer tu opinión sobre cómo te funciona esta nueva vista y tus sugerencias para mejorarla aún más. Si tienes alguna sugerencia, pregunta o comentario, puedes enviarla en LinkedIn o publicar en la Comunidad de Google Search Central

Fuente https://developers.google.com/search/blog/2025/04/san-hourly-data