La API de Search Analytics ahora admite datos por hora

Miércoles, 9 de abril de 2025

Hace unos meses, anunciamos una forma mejorada de ver los datos de rendimiento recientes en Search Console. La vista "24 horas" incluye datos de las últimas 24 horas disponibles y aparece con un retraso de solo unas horas. Esta vista puede ayudarte a encontrar información sobre qué páginas y consultas tienen un buen rendimiento en este período reciente y cómo se está popularizando el contenido que publicaste recientemente.

Hoy, agregamos compatibilidad con los datos por hora a la API de Search Analytics. Escuchamos las solicitudes del ecosistema para que estos datos sean más accesibles. Como resultado, agregaremos datos por hora a la API y 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 mostrará datos de hasta 10 días con un desglose por hora. Esto permitirá a los desarrolladores crear soluciones para mostrar no solo los datos por hora del día más reciente, sino también comparar el día más reciente con el mismo día de la semana anterior, lo que puede ser útil cuando se analizan patrones para 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, implementaremos 2 cambios en el cuerpo de la solicitud de la API:

• Nuevo ApiDimension llamado HOUR para que agrupes la respuesta por hora.
• Nuevo valor dataState llamado HOURLY_ALL, que se debe usar cuando se agrupa por HORA. Esto indicará que los datos por hora pueden ser parciales.

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

Solicitud a la API de muestra

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

Ejemplo de respuesta de la 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 estos nuevos datos te ayuden a supervisar mejor el contenido que publicaste recientemente de una manera más eficaz y a tomar medidas de forma oportuna. Nos encantaría conocer tu opinión sobre esta nueva vista y recibir sugerencias sobre cómo mejorarla aún más. Si tienes comentarios, preguntas o sugerencias, puedes encontrarnos en LinkedIn o publicar en la Comunidad de la Central de la Búsqueda de Google.

Publicado por Tali Pruss, ingeniería de software, y Daniel Waisberg, representante de la Búsqueda