La API Search Analytics ahora admite datos por horas

Miércoles, 9 de abril del 2025

Hace unos meses anunciamos una forma mejorada de consultar 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 el rendimiento de las páginas y consultas en este periodo reciente, y sobre el contenido que has publicado recientemente.

Hoy, vamos a añadir compatibilidad con datos por horas a la API Search Analytics. Hemos escuchado las peticiones del ecosistema para que estos datos sean más accesibles. Por eso, vamos a añadir datos por horas a la API con un ámbito más amplio que el de la interfaz del producto: mientras que el producto muestra los datos por horas solo de las últimas 24 horas, la API devolverá datos de hasta 10 días con un desglose por horas. Esto permitirá a los desarrolladores crear soluciones que muestren no solo los datos por horas del día más reciente, sino también una comparación entre el día más reciente y el mismo día de la semana anterior, lo que puede resultar útil a la hora de analizar patrones de los días de la semana.

Cómo extraer datos por horas de la API Search Analytics

Para que los datos por horas estén disponibles en la API Search Analytics, vamos a introducir dos cambios en el cuerpo de la solicitud de la API:

• Nuevo ApiDimension llamado HOUR para que agrupes la respuesta por hora.
• Nuevo valor de dataState llamado HOURLY_ALL, que se debe usar al agrupar por HORA. Esto indica que los datos por hora pueden ser parciales.

En la siguiente sección se incluyen una solicitud a la API de ejemplo y una respuesta de ejemplo a modo de referencia.

Solicitud de ejemplo a la API

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

Respuesta de ejemplo 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 monitorizar mejor el contenido publicado recientemente de una forma más eficaz y que puedas 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 alguna sugerencia, pregunta o comentario, puedes ponerte en contacto con nosotros en LinkedIn o publicar un mensaje en la comunidad del Centro de la Búsqueda de Google.

Publicado por Tali Pruss, ingeniera de software, y Daniel Waisberg, Search Advocate