API de Google Search Console: Una guía de todos los datos disponibles

Resumen Ejecutivo

Este informe ofrece un análisis exhaustivo de la API de Google Search Console (GSC) – qué datos y funciones expone, cómo se puede utilizar y sus implicaciones prácticas para propietarios de sitios web y desarrolladores. La API de GSC (anteriormente la “API de Webmasters”) permite el acceso programático a los datos de rendimiento de búsqueda de Google y herramientas relacionadas, complementando o superando lo que es visible en la interfaz de usuario web. Las capacidades clave incluyen la consulta de Search Analytics (recuperación de clics, impresiones, CTR y posiciones para consultas y páginas), la gestión de Sitemaps (listado, envío y eliminación de sitemaps XML), la gestión de Sitios (adición/eliminación/listado de propiedades verificadas y niveles de permiso), y la herramienta de Inspección de URL (obtención del estado de indexación, usabilidad AMP/móvil y detalles de resultados enriquecidos para URLs individuales) ^{[1] [2]}. Revisamos cada una de estas, citando la documentación de Google y análisis independientes.

El informe también examina las restricciones de uso (cuotas, límites de datos, retrasos) y cómo los usuarios experimentados las superan. Por ejemplo, las consultas de rendimiento devuelven un máximo de ~50.000 filas por día por sitio y típicamente cubren los últimos ~16 meses con una latencia de ~2-3 días ^[3] (Source: mikelev.in). Discutimos cómo las empresas aprovechan la API: el caso Google-Wix amplió enormemente el acceso (más de 2 millones de sitios conectados a través de la API) y reporta ganancias promedio de tráfico del +15% y un valor de comercio electrónico un 24% mayor ^[4]. El informe incluye detalles cuantitativos, como valores específicos de cuota y estructuras de datos, y ejemplos prácticos (p. ej., exportación a través de BigQuery) para ilustrar su uso. Finalmente, consideramos las limitaciones (la API omite ciertos datos como informes de enlaces y algunas funciones de cobertura de indexación ^{[5] [6]}) y las tendencias futuras, señalando cómo Google fomenta una integración más profunda de los datos de búsqueda en paneles de control de terceros ^{[7] [8]}. Todas las afirmaciones están respaldadas por fuentes autorizadas, incluyendo la documentación para desarrolladores de Google y medios de investigación de SEO.

Introducción y Antecedentes

Google Search Console es la herramienta oficial de Google para que los webmasters supervisen y mejoren la presencia de su sitio en la Búsqueda de Google. Lanzada en 2006 como Google Webmaster Tools, fue renombrada en 2015 a Google Search Console para abarcar una audiencia más amplia más allá de los “webmasters” tradicionales ^[9]. La interfaz web proporciona informes sobre rendimiento de búsqueda (clics, impresiones, CTR, posición media, por consulta o página), estado de cobertura/indexación, usabilidad móvil, mejoras de datos estructurados, acciones de seguridad/manuales y más. Sin embargo, los informes más “ricos en datos” (como Rendimiento) limitan intencionalmente las vistas en el navegador (p. ej., mostrando solo las 1.000 principales consultas para el rango de fechas) ^{[10] [6]}.

Para superar estas limitaciones de la interfaz de usuario, Google ofrece la API de Search Console (también llamada API de Search Console (Webmasters), v3) que expone piezas clave de datos de GSC a aplicaciones externas. Según Google, “la API de Search Console proporciona funciones de gestión y prueba, y funcionalidad de descarga de datos para datos de rendimiento y datos de sitemaps.” ^[1]. En otras palabras, se pueden consultar programáticamente métricas de rendimiento del sitio, gestionar sitemaps e interactuar con la configuración del sitio en lugar de hacer clic en el navegador. La API es de uso gratuito (sujeto a cuotas) y permite la automatización y el análisis personalizado que la UI no puede, lo cual es especialmente valioso para sitios medianos a grandes y agencias ^{[11] [6]}.

Este informe examina todo lo accesible a través de la API de GSC. Cubrimos cada recurso principal de la API (Rendimiento/Search Analytics, Sitemaps, Sitios, Inspección de URL) en profundidad: describiendo los datos devueltos, los métodos disponibles y cómo se mapean a la interfaz de Search Console. También examinamos los límites técnicos (cuota, antigüedad de los datos, límites de filas), multitud de parámetros y filtros, y aplicaciones en el mundo real. Estudios de caso y ejemplos (como la integración de Wix) ilustran cómo las organizaciones aprovechan la API para mejoras de SEO. Citamos la documentación oficial de Google y análisis independientes en todo el informe, proporcionando una visión general rigurosa y respaldada por referencias de las capacidades y el contexto de la API de GSC.

Visión General de la API de Google Search Console

La API de Search Console está estructurada en varios tipos de recursos: searchAnalytics, sitemaps, sites y urlInspection. Cada recurso soporta métodos (puntos finales HTTP) para recuperar o gestionar datos relacionados con ese concepto. La Tabla 1 resume los principales recursos de la API, sus métodos y los tipos de datos disponibles.

Tabla 1: Resumen de los recursos, métodos y datos de la API de Google Search Console.

Cada uno de los anteriores está respaldado por la documentación oficial de Google. Por ejemplo, Google señala que la API de Search Analytics “permite consultar los datos de tráfico de búsqueda de su sitio web con filtros y parámetros personalizados…” ^[17], y su punto final query devuelve filas que contienen clics, impresiones, ctr y posición para cada agrupación de resultados ^[18]. De manera similar, la API de Sitemaps “proporciona información detallada sobre las URLs enviadas a través de un archivo sitemap, incluyendo la fecha de envío, la fecha de descarga y los recuentos de errores/advertencias” ^[12], y el recurso Sitemap devuelto lista los tipos de contenido (p. ej., web, image, video, etc.) y los recuentos de URLs enviadas ^[13]. La API de Sitios muestra claramente que devuelve objetos con siteUrl y permissionLevel, donde el permiso puede ser “siteOwner”, “siteFullUser”, etc. ^[19]. El recurso de Inspección de URL devuelve un objeto cuyo esquema JSON (mostrado en el sitio de Google) incluye claves como indexStatusResult, ampResult y richResultsResult ^[16]; en particular, la sección de estado de indexación tiene campos como sitemap, referringUrls, verdict, robotsTxtState, indexingState y lastCrawlTime ^[20].

Estos recursos y métodos forman la columna vertebral de lo que la API de GSC puede “obtener”. En las siguientes secciones, profundizamos en cada área, describimos cómo usarla, qué datos exactos se obtienen y cómo se puede aplicar en la práctica.

Datos de Search Analytics a través de la API

Consulta de Datos de Rendimiento

El método searchAnalytics.query (HTTP POST a .../searchanalytics/query) devuelve datos de tráfico de la Búsqueda de Google para su sitio. En la práctica, debe especificar un rango de fechas y opcionalmente [agrupar por dimensiones] (dimensiones como país, tipo de dispositivo, URL de página, consulta de búsqueda, etc.), así como filtros sobre esas dimensiones ^[21]. La documentación de Google explica: “El método devuelve cero o más filas agrupadas por las claves de fila (dimensiones) que usted defina. Debe definir un rango de fechas de uno o más días.” ^[21]. Cada fila de respuesta contiene los valores de las dimensiones solicitadas más las métricas estándar: clics, impresiones, ctr y posición ^[18]. Por defecto, los resultados se ordenan por recuento de clics de forma descendente ^[22].

Por ejemplo, un JSON del cuerpo de la solicitud podría verse así:

{
  "startDate": "2025-01-01",
  "endDate":   "2025-01-31",
  "dimensions": ["date","device"],
  "dimensionFilterGroups": [
    {
      "filters": [
        { "dimension": "country", "operator": "equals", "expression": "United States" }
      ]
    }
  ]
}

Esto agruparía los datos por fecha y dispositivo (claves de fila respectivas), restringido a búsquedas desde EE. UU. El JSON de respuesta incluiría filas como:

"rows": [
  { "keys": ["2025-01-01","MOBILE"], "clicks": 123, "impressions": 4567, "ctr": 0.0269, "position": 12.3 },
  { "keys": ["2025-01-01","DESKTOP"], "clicks": 98,  "impressions": 3201, "ctr": 0.0306, "position": 15.4 },
  { "keys": ["2025-01-02","MOBILE"], "clicks": 135, "impressions": 4678, "ctr": 0.0289, "position": 11.8 },
  ...
]

Como se muestra, el array de claves de cada fila corresponde a las dimensiones solicitadas, y los campos numéricos clicks, impressions, ctr y position proporcionan esa métrica para la agrupación ^[18]. La documentación de la API lista explícitamente estos campos bajo rows[] ^[18], confirmando que todas las métricas principales del informe de Rendimiento se entregan a través de la API.

Dimensiones y Filtros

La API soporta la agrupación/informe por las mismas dimensiones disponibles en la UI, y también el filtrado por dimensiones. Las dimensiones permitidas para agrupar incluyen country, device, page, query, searchAppearance, y también date y hour (para series temporales) ^{[21] [23]}. Para los filtros, puede filtrar por country, device, page, query o searchAppearance (estos se especifican en dimensionFilterGroups de la solicitud) ^[24]. Los filtros de país usan códigos ISO de 3 letras ^[25], los filtros de dispositivo aceptan valores como DESKTOP, MOBILE, TABLET ^[26], y los filtros de searchAppearance coinciden con las características de la UI (p. ej., tipos de resultados enriquecidos) ^[27].

Por ejemplo, para filtrar solo el tráfico móvil, incluiría:

"dimensionFilterGroups":[{"filters":[{"dimension":"device","operator":"equals","expression":"MOBILE"}]}]

También puede filtrar por texto de consulta. Si quisiera solo filas donde la consulta contenga una palabra (por ejemplo, “shoes”), podría añadir un filtro como { "dimension": "query", "operator": "contains", "expression": "shoes" } ^[28]. Dado que múltiples filtros en un grupo se combinan con AND, puede combinar filtros (p. ej., país=EE. UU. Y dispositivo=MÓVIL). Una diferencia clave con la UI es que solo ciertas dimensiones pueden ser filtradas; por ejemplo, no puede filtrar por valores de “consulta” arbitrarios fuera de los operadores permitidos o por “sitio” (el sitio se establece por la propiedad elegida).

Tipo de Búsqueda y Apariencia de Búsqueda

Tipo de búsqueda y Apariencia en la Búsqueda

Además de las dimensiones, la consulta puede restringirse a tipos particulares de resultados de búsqueda. El parámetro searchType puede configurarse con valores como web (predeterminado), image, video, news o discover. Esto corresponde a filtrar por el selector "Tipo de búsqueda" en la interfaz de usuario de Search Console. Cabe destacar que, a finales de 2020, Google añadió soporte para configurar searchType: "news" y searchType: "discover" ^[29], lo que coincide con las nuevas pestañas "Discover" y Noticias en la interfaz de usuario. (Por ejemplo, una consulta con searchType: "news" devolverá solo clics/impresiones de Google Noticias). La documentación antigua todavía menciona type (nombre obsoleto) y el nuevo campo searchType para este propósito ^[30]. El uso de searchType: "image" o "video" filtra de manera similar a los resultados de búsqueda de Imágenes o Videos.

Para la Apariencia en la Búsqueda, la API también permite agrupar o filtrar por características de búsqueda (como listados AMP, resultados enriquecidos de preguntas frecuentes, etc.) a través de la dimensión searchAppearance (sus posibles valores pueden descubrirse agrupando con esa dimensión o consultando la documentación de ayuda de Google) ^[27]. Esto cubre lo que la interfaz de usuario denomina el filtro "Apariencia en la Búsqueda" o "Funciones de búsqueda".

Cuotas y Límites

Google aplica cuotas sobre la cantidad de datos que se pueden extraer a través de la API. Las consultas de Search Analytics están limitadas tanto por cuotas a corto plazo (10 minutos) como por cuotas diarias a largo plazo, así como por límites de QPS/QPM/QPD (consultas por segundo/minuto/día) ^{[31] [32]}. Un resumen útil de los límites actuales (a mediados de 2025) es:

• QPM por sitio y por usuario: 1.200 QPM. (Así, una única combinación de usuario/propiedad no puede exceder las 1.200 llamadas por minuto).
• QPM por proyecto: 40.000 QPM (en todos los sitios/proyectos bajo la misma clave API) ^{[33] [32]}.
• QPD por proyecto: 30.000.000 QPD (para Search Analytics) ^{[33] [32]}.
• Inspección de URL (por sitio): 600 QPM, 2.000 QPD; Inspección de URL (por proyecto): 15.000 QPM, 10.000.000 QPD ^{[34] [32]}.
• Otros recursos (Sitios, Sitemaps): típicamente limitados a 20 QPS y 200 QPM por usuario ^{[35] [32]}.

Estas cuotas significan que las consultas de muy alto volumen deben ser reguladas. Por ejemplo, las consultas de Search Analytics que agrupan por consulta o página son "costosas": Google señala que las consultas agrupadas/filtradas por página y cadena de consulta consumen mucha cuota ^[36]. Las consultas sobre rangos de fechas muy grandes también cuestan más. Se aconseja a los usuarios que distribuyan las llamadas, almacenen en caché los resultados y reduzcan las solicitudes redundantes ^{[37] [38]}. En la práctica, exceder la cuota a corto plazo provoca un error de "cuota excedida", y las soluciones son esperar o reducir la complejidad de la consulta ^{[39] [40]}.

Otra limitación clave son los límites de filas. Google establece explícitamente que las solicitudes de Search Analytics pueden devolver como máximo 50.000 filas por día, por tipo de búsqueda y por propiedad ^[3]. Si una consulta arrojara más, los resultados se truncan (ordenados por clics descendentes) y la paginación se detiene en aproximadamente 50.000 filas totales (Source: mikelev.in) ^[3]. En otras palabras, no se puede superar ese límite paginando más resultados; una vez que se alcanzan aproximadamente 50.000, la API devuelve las filas superiores por clics y omite el resto (Source: mikelev.in). Esto a menudo obliga a los usuarios a dividir las consultas (por ejemplo, por rangos de fechas o país) para obtener todos los datos.

Datos recientes vs. Datos finales

Por defecto, la API de Search Analytics devuelve solo datos finalizados (métricas estables). Sin embargo, en diciembre de 2020, Google añadió una opción para recuperar datos más recientes (pero no finales) utilizando el parámetro dataState ^[41]. Configurar "dataState": "all" en la consulta devuelve datos que pueden incluir los últimos 1-2 días (marcados como "frescos"), mientras que omitirlo (o usar "final") produce solo datos completamente procesados (con el retraso típico de 2 días) ^{[41] [42]}. La respuesta de la API incluye un bloque metadata que indica si alguna fecha/hora devuelta está incompleta (debido a la frescura) ^[42]. Esto permite a los usuarios avanzados ver tendencias actualizadas al minuto (a costa de cierta volatilidad) consultando con dataState: "all" y observando las fechas hasta first_incomplete_date en los metadatos ^[42].

Campos de datos e interpretación

La API devuelve datos numéricos de forma muy similar al informe de la interfaz de usuario. Específicamente, cada fila devuelta para Search Analytics tiene:

• clicks (doble) – número de clics.
• impressions (doble) – número de impresiones.
• ctr (doble) – tasa de clics (0 a 1) en esa fila ^[18].
• position (doble) – posición promedio del resultado.

Estos campos están documentados en la referencia de la API ^[18]. Todas las métricas utilizan las definiciones estándar de Google. Es importante tratar position como un promedio ponderado (la documentación de Google aclara cómo calcular el promedio a partir de sumTotalsPosition si es necesario). El CTR se da como una fracción (por ejemplo, 0.10 para el 10%). Es importante destacar que, al igual que la interfaz de usuario, la API omite los días sin datos al agrupar por date ^[21]; se puede consultar sin dimensiones para ver qué fechas tienen datos.

Dado que la API devuelve números brutos, permite un control completo para construir sus propios informes o pipelines de datos. Por ejemplo, un enfoque común es extraer muchas consultas de Search Analytics a través de la API y cargarlas en una base de datos o sistema de análisis. Google incluso recomienda a los desarrolladores usar BigQuery o similar para un análisis más profundo. (Consulte la sección de BigQuery a continuación).

Comparación con las limitaciones de la interfaz de usuario

El uso de la API a menudo revela muchos más datos que la interfaz web. Por ejemplo, la interfaz de usuario de Search Console solo muestra hasta 1.000 consultas de búsqueda para un rango de fechas determinado. En contraste, como señala una guía de análisis, “la API de Google Search Console… le permite acceder hasta a 25.000 filas de datos” a través de Google Sheets, y BigQuery puede proporcionar “todos los datos brutos” ^[10]. En resumen, la API desbloquea eficazmente todos los datos de consulta (sujetos al límite de 50.000) y permite un filtrado/agrupación que la interfaz de usuario no permite. Esto ha sido un cambio radical para el SEO. Como explica un análisis de SEO, la API puede extraer “detalles más granulares sobre el rendimiento de su sitio web” – por ejemplo, desglosando impresiones/clics por consulta, dispositivo, país, fecha, etc. – lo que la interfaz de usuario no puede hacer ^[8]. También permite paneles personalizados: puede enviar datos de la API a Google Sheets, Looker Studio o cualquier herramienta de BI para hacer referencias cruzadas con otras fuentes de datos ^{[43] [44]}.

Por ejemplo, usando la API puede responder preguntas como ¿Qué consultas específicas están generando la mayor cantidad de nuevas impresiones esta semana? agrupando por query y ordenando por impressions. O puede filtrar por un país (o por páginas que contienen una subcadena, usando filtrado de expresiones regulares) para realizar análisis de cohortes. Estas operaciones, difíciles o imposibles en la interfaz de usuario, son sencillas a través del mecanismo de filtrado de la API. Los desarrolladores también pueden muestrear o paginar a través de listas de consultas, fusionar múltiples consultas en código y aplicar cálculos personalizados que la interfaz de usuario no admite.

Sin embargo, la API no es un espejo completo de cada informe de la interfaz de usuario. Ciertos datos, como el panel de contexto del informe de Páginas Principales con el desglose de "Funciones de búsqueda", deben construirse manualmente mediante múltiples llamadas a la API si es necesario. Y como se señaló, no existe una API directa para el informe de "Enlaces" ni para muchos informes de mejoras/errores. No obstante, para los datos de rendimiento brutos, la API de Search Analytics es la fuente autorizada.

Ejemplo práctico: Combinación con otras herramientas

Muchos flujos de trabajo de SEO del mundo real ahora se centran en la API de GSC. Por ejemplo, Screaming Frog (una popular herramienta de rastreo SEO) puede importar datos de Search Console a través de la API y fusionarlos con datos de rastreo del sitio ^[45]. Los plugins de WordPress (por ejemplo, “Search Console” o “Search Engine Insights”) utilizan la API para mostrar los clics/impresiones de GSC dentro del panel de WP, uniendo los datos de Google con el contenido. Las grandes plataformas están haciendo lo mismo: el propio caso de estudio de Google sobre Wix destaca que Wix integró “las API de Google Search Console dentro del panel de Wix, agilizando el proceso de SEO para millones de usuarios de Wix” ^[46]. Esto permitió a los sitios de Wix ver información de GSC (como el rendimiento de búsqueda y el envío de sitemaps) directamente en su interfaz de creación, sin necesidad de ir a la interfaz de usuario de Google ^[46]. En palabras de Cypress: “Los usuarios se benefician al obtener un fácil acceso a [Google Search Console] dentro del familiar panel de Wix, manteniendo una experiencia unificada” ^[46]. El impacto fue sustancial: Wix informa que más de 2 millones de sitios de Wix conectaron sus cuentas de Search Console a través de la nueva integración de la API, y los usuarios que la adoptaron vieron aumentos promedio de tráfico del 15% y un aumento del 24% en los ingresos de productos de comercio electrónico en un año ^[4].

Estos casos subrayan cómo la API permite a los operadores de sitios convertir sus estadísticas de SEO en mejoras accionables. Al consultar la API, se pueden encontrar rápidamente problemas de indexación (por ejemplo, páginas que no se indexan o con baja cobertura) y luego solucionarlos, todo en un bucle automatizado. Por ejemplo, el blog de coupler.io sugiere usar los datos de la API para "detectar y resolver rápidamente problemas como errores de sitemap o problemas de indexación" ^[8]. Si una consulta de la API muestra una caída en las impresiones en ciertas páginas, un script podría activar un nuevo rastreo o el envío de URL. De manera similar, si "lastCrawlTime" en los resultados de la Inspección de URL se retrasa con respecto a la implementación, se podría solicitar automáticamente una reindexación.

Restricciones de retención y frescura de datos

Es importante tener en cuenta cómo Search Console limita el historial y la frescura de los datos. Google retiene solo los últimos 16 meses de datos de rendimiento (Source: mikelev.in). Por lo tanto, las consultas no pueden recuperar datos anteriores a aproximadamente 16 meses antes de hoy. Si necesita datos más antiguos, debe almacenarlos usted mismo (por ejemplo, exportándolos regularmente a través de la API o BigQuery). Debido a esta ventana fija, los analistas de SEO a menudo programan exportaciones regulares de la API a sus propias bases de datos. Además, Google suele actualizar los datos de rendimiento con un retraso de aproximadamente 2 días (Source: mikelev.in). En otras palabras, si hoy es 25 de octubre, los datos de rendimiento más recientes que puede obtener probablemente serán del 23 de octubre o anteriores. La configuración "dataState" de la API y los metadatos (como se mencionó anteriormente) ayudan a gestionar esto: puede obtener explícitamente los datos más recientes (con dataState: "all") o solo datos estables. Pero en cualquier caso, debe asumir un retraso de aproximadamente 48 horas en las métricas de Search Analytics (Source: mikelev.in), tal como lo indica la documentación de la interfaz de usuario ^[47].

Resumen de Search Analytics a través de la API

En resumen, la API de Search Analytics es la forma principal de recuperar métricas de rendimiento de Google de forma masiva. Le proporciona los mismos datos centrales que el Informe de Rendimiento de la Consola (clics, CTR, etc.), pero permite combinaciones infinitas: puede desglosar por consulta, por página o tabular por país o dispositivo. Maneja cualquier rango de fechas (hasta 16 meses) y cada tipo de búsqueda (Web, Imagen, Video, Noticias, Sitemap/Discover). Los datos se ordenan por clics por defecto y están limitados por cuota y por un tope de 50.000 filas por consulta ^[3] (Source: mikelev.in). Si bien no expone funciones avanzadas solo de la interfaz de usuario (como recuentos de enlaces o errores de mejora de página), para muchas tareas de optimización proporciona todos los números necesarios en formato programable. Los numerosos casos de estudio y escritos de expertos confirman que aprovechar la API puede “extraer detalles más granulares” que la interfaz de usuario ^[8] y habilitar potentes análisis de SEO en código y paneles.

Gestión de Sitemaps a través de la API

El informe de Sitemaps de Google Search Console también puede ser gestionado a través de la API. El recurso Sitemaps tiene métodos para listar sitemaps, recuperar sus estadísticas, subir una nueva URL de sitemap o eliminar un sitemap existente de una propiedad. Esto es útil para automatizar el envío y la monitorización de sitemaps.

Cuando llama a sitemaps.list, obtiene todas las entradas de sitemap enviadas bajo esa propiedad del sitio. Devuelve una lista de recursos Sitemap, cada uno con campos detallados ^[48]. Los campos clave en un recurso Sitemap incluyen:

• path: la URL completa del archivo sitemap.
• lastSubmitted: marca de tiempo de la última vez que este sitemap fue enviado a Google.
• lastDownloaded: marca de tiempo de la última vez que Google descargó este sitemap (si ha sido procesado).
• isPending: booleano, verdadero si el sitemap está en cola o en progreso.
• isSitemapsIndex: booleano, verdadero si este es un índice de otros sitemaps (en lugar de una lista de URLs).
• warnings y errors: recuentos de cuántas advertencias/errores encontró Google en el archivo sitemap.
• contents: una lista de subobjetos que enumeran cada tipo de contenido con sus recuentos. Por ejemplo, una entrada podría tener "type": "web", "submitted": 1234, indicando que se listaron 1.234 URLs de páginas web en este sitemap. Los tipos permitidos incluyen páginas web, imágenes, videos, noticias, páginas móviles, aplicaciones de Android, aplicaciones de iOS y patrones ^[13]. Esto coincide con los tipos enriquecidos admitidos por Search Console (un sitemap de sitio web, un sitemap de imágenes, un sitemap de Google Noticias, un sitemap de video, etc.).

Estos campos reflejan exactamente lo que la interfaz de usuario de Search Console muestra en la página de Sitemaps. Por ejemplo, [23] señala que “el recurso sitemap proporciona información detallada sobre las URLs enviadas… incluyendo la fecha de envío, la fecha de descarga y los recuentos de errores/advertencias” ^[12]. De hecho, si inspecciona la salida de la API, verá líneas como:

{

{
  "path": "https://www.example.com/sitemap.xml",
  "lastSubmitted": "2025-10-01",
  "lastDownloaded": "2025-10-02",
  "isPending": false,
  "errors": 0,
  "warnings": 2,
  "contents": [
    {"type": "web",     "submitted": 250, "indexed": 240},
    {"type": "image",   "submitted":  50, "indexed":  45}
  ]
}

Esto significaría que sitemap.xml fue enviado por última vez el 1 de octubre y descargado por última vez el 2 de octubre (formato RFC3339). Se listan 0 errores de procesamiento y 2 advertencias. Contenía 250 URLs de página de tipo "web" (240 de las cuales fueron indexadas) y 50 URLs de "imagen" (45 indexadas). (Nota: el campo indexed en contents solía estar documentado como N/A, pero muchas respuestas de la API lo incluyen; en cualquier caso, puedes rastrear la indexación por separado).

Métodos: Listar, Obtener, Enviar, Eliminar

La API de Sitemaps tiene los siguientes métodos:

• list – GET /webmasters/v3/sites/{siteUrl}/sitemaps – Lista todos los sitemaps para la propiedad del sitio dada ^[49]. Se proporciona la ruta siteUrl como con otros recursos (por ejemplo, http://www.example.com/ o sc-domain:example.com ^[50]). La respuesta contiene un array de recursos de Sitemap como el anterior.

• get – GET /webmasters/v3/sites/{siteUrl}/sitemaps/{sitemapUrl} – Recupera detalles para un sitemap específico (usando su URL completa como identificador). Devuelve el recurso de Sitemap individual, idéntico a lo que está en la lista.

• submit – PUT /webmasters/v3/sites/{siteUrl}/sitemaps/{sitemapUrl} – Le indica a Search Console "aquí hay un sitemap que quiero que rastrees". Úsalo para añadir un sitemap (o volver a añadir la misma URL después de actualizarla). Google buscará y procesará el sitemap pronto. Esto es equivalente a hacer clic en "Añadir/Probar Sitemap" en la interfaz de usuario. Requiere que {sitemapUrl} coincida con el dominio de la propiedad del sitio.

• delete – DELETE /webmasters/v3/sites/{siteUrl}/sitemaps/{sitemapUrl} – Elimina un sitemap de la propiedad. Esto no elimina el archivo del servidor; simplemente le dice a Google que lo olvide (eliminándolo del informe de Sitemaps).

Estos métodos permiten a los desarrolladores automatizar completamente la gestión de sitemaps. Por ejemplo, un script de compilación podría generar automáticamente un nuevo sitemap.xml cada noche y llamar a la API submit para enviarlo a Google (asegurando que los Sitemaps se mantengan actualizados). Los scripts de monitoreo regulares pueden llamar a get o list para verificar si algún sitemap tiene errores o ha pasado más de "X días" sin ser descargado (indicando que Google no está viendo contenido nuevo). Si aparece un error, el script podría notificar a un administrador o intentar una solución antes de que el tráfico de búsqueda se vea afectado.

Propiedades de dominio y Sitemaps

En diciembre de 2020, Google anunció que la API de Sitemaps ahora soporta propiedades de dominio de la misma manera que otras APIs ^[14]. En la práctica, esto significa que puedes usar una siteUrl como sc-domain:example.com en lugar de un prefijo de URL (por ejemplo, http://www.example.com/) al llamar a la API. Por ejemplo, la entrada del blog da un ejemplo de solicitud GET:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

^[51]. Si la propiedad ha sido verificada a nivel de dominio (cubriendo todos los subdominios y protocolos), esto listará todos los sitemaps a través de ellos. Esto hace que la API se alinee con la interfaz de usuario de Search Console que trata las propiedades "Dominio" frente a "Prefijo de URL". (De manera similar, todos los demás recursos aceptan el prefijo sc-domain: en su parámetro de ruta siteUrl ^[50].)

Casos de uso de ejemplo

Monitoreo de la salud del sitemap: Supongamos que tienes un sitio web de noticias con sitemaps diarios (daily1.xml, daily2.xml, etc.). Un trabajo programado podría llamar a sitemaps.list cada mañana y marcar cualquier entrada de sitemap donde errors > 0 o donde lastDownloaded indique que el sitemap no ha sido recuperado recientemente (quizás Google no lo ha visto en una semana). Si se encuentra un recuento de errores, el script podría registrar los detalles o enviar una alerta. Esta verificación proactiva se basa en los recuentos brutos de la API que la interfaz de usuario solo mostraría de forma inferencial.

Envío automatizado: Una pipeline de despliegue continuo para un sitio podría incluir un paso: "Después de desplegar nuevas entradas de blog, recrear el sitemap.xml y enviarlo a través de la API." Llamar a sitemaps.submit con la nueva URL del sitemap asegura que Google vuelva a rastrear el sitemap actualizado inmediatamente. Esto puede acelerar la indexación de contenido fresco. (De hecho, en el caso de estudio de Wix, señalan "enviaron un sitemap a Google a través de la nueva integración" para 2 millones de sitios ^[52].)

Agregación de estadísticas de sitemap: Si tienes docenas de sitemaps, puedes agregar su recuento total de URLs a través de un simple bucle de llamadas a la API. Por ejemplo, en Python se podría iterar sobre sitemaps.list, sumando todos los recuentos de contents[].submitted para obtener el total de URLs enviadas. Esto podría almacenarse en un almacén de datos para análisis de tendencias (por ejemplo, si el sitio está creciendo linealmente).

Recurso Sites

El recurso Sites rige tu conjunto de propiedades y permisos de Search Console. Esto se trata más de gestión que de análisis de datos. Usando sites.list, puedes recuperar todas las propiedades del sitio a las que el usuario autenticado tiene acceso (similar a ver los "sitios" listados en Search Console). Cada entrada tiene:

• siteUrl (string): la URL de la propiedad, ya sea como http://www.example.com/ o el formato de dominio sc-domain:example.com.
• permissionLevel (string): tu nivel de acceso en ese sitio, que puede ser siteOwner, siteFullUser, siteRestrictedUser o siteUnverifiedUser ^[19].

La documentación de la API señala: "Este recurso describe los niveles de permiso del sitio dentro de Search Console... incluyendo detalles sobre los roles de propietario, usuario completo, usuario restringido y usuario no verificado." ^[53]. Un ejemplo de entrada podría ser:

{"siteUrl": "sc-domain:example.com", "permissionLevel": "siteOwner"}

lo que significa que el usuario es propietario de la propiedad que cubre example.com.

Los métodos en este recurso permiten:

• add: POST a /sites/add – añade una propiedad de sitio a la cuenta del usuario (no verificará instantáneamente la propiedad; solo configura la propiedad si el llamante ya es un propietario autorizado en Search Console). Esto es análogo a ir a "Añadir propiedad" en la interfaz de usuario.
• delete: POST a /sites/delete – elimina ese sitio (como "eliminar propiedad").
• get: POST a /sites/get – recupera el permiso/información para un sitio.
• list: GET /sites/list – lista todos los sitios del usuario y sus niveles de permiso.

Estos pueden usarse para automatizar la configuración de la cuenta. Por ejemplo, una organización que adquiere un nuevo dominio podría usar la API (con suficientes ámbitos OAuth) para añadir la propiedad de dominio a Search Console y luego programar el proceso de verificación a través de DNS. Las agencias pueden usar sites.list para compilar un informe de todos los sitios de clientes que gestionan.

Ten en cuenta que en todas las llamadas especificas el parámetro siteUrl. Como con otras APIs, este puede ser la URL completa o el formato sc-domain: ^[50]. Por ejemplo, [25] muestra explícitamente ejemplos: una siteUrl podría ser "http://www.example.com/" o "sc-domain:example.com" ^[50]. La documentación de la API aclara que estos corresponden a propiedades de prefijo de URL frente a propiedades de dominio.

Dado que la gestión del sitio no es intensiva en datos, no hay un "límite" real en la llamada a estos métodos más allá de los límites de tasa normales en la interfaz de usuario (generalmente ~10 QPS). El principal caso de uso es simplemente automatizar los flujos de trabajo.

Inspección de URL (Inspección de índice) a través de la API

La API de Inspección de URL te permite obtener programáticamente la misma información que ves cuando escribes una URL en la herramienta "Inspección de URL" de Search Console. Esto es distinto de las APIs de rendimiento y sitemaps; es un recurso separado llamado urlInspection/index: con el método inspect. Es esencialmente un cliente REST para el informe de estado en vivo/índice de la consola de desarrolladores de Chrome para una URL.

El método principal es index.inspect (POST a .../index:inspect) con un cuerpo JSON que especifica:

• La propiedad (siteUrl) de la URL a inspeccionar.
• La URL en sí (inspectionUrl).
• Un parámetro booleano inspectionDepth (si se establece en "FULL", realiza una nueva recuperación en vivo del contenido de la URL; de lo contrario, Google generalmente solo devuelve el estado de su índice). Por ejemplo:

{
  "inspectionUrl": "https://example.com/somepage.html",
  "siteUrl": "sc-domain:example.com",
  "inspectionDepth": "FULL"
}

La respuesta tiene un objeto JSON llamado UrlInspectionResult (ver Tabla 2, fragmento a continuación), que contiene varios subobjetos: indexStatusResult, ampResult, mobileUsabilityResult y richResultsResult ^[16].

Tabla 2 – Campos de ejemplo devueltos en un UrlInspectionResult (simplificado):

Tabla 2: Campos clave en los resultados de la API de Inspección de URL (campos bajo indexStatusResult, ampResult, etc.), según la documentación de Google ^[20].

Los campos anteriores provienen directamente de la documentación oficial de la API ^[20]. Por ejemplo, referringUrls y sitemap muestran cualquier enlace o sitemap conocido que apunte a la URL ^[20]. verdict es la evaluación general de Google (PASS = válido/indexado, FAIL = error) para cada sección (por ejemplo, para resultados enriquecidos o AMP). lastCrawlTime te da la marca de tiempo (formato RFC3339) de la última recuperación exitosa de Google ^[56].

Usando esto, un desarrollador puede verificar si una página está indexada y por qué sí/no. Por ejemplo, si indexStatusResult.verdict es FAIL, robotsTxtState o pageFetchState a menudo indicarían si fue bloqueada, o si la página devolvió un 404. Si indexingState es BLOCKED_BY_META_TAG, sabes que hay una etiqueta noindex. La presencia de los campos googleCanonical frente a userCanonical puede revelar si Google eligió una canónica diferente a la declarada. En resumen, replica el informe de Cobertura del Índice en vivo para una URL, pero en formato JSON.

Se puede llamar a la Inspección de URL repetidamente en muchas páginas para construir programáticamente un informe de cobertura. Por ejemplo, un script podría iterar sobre todas las URLs del sitio (desde un sitemap o una base de datos) y llamar a index.inspect, luego registrar cualquier URL que tenga verdict: FAIL o errors en los resultados. Esto es similar a la "Inspección de URL" masiva desde la GUI, pero ahora automatizada. La documentación de Google destaca esto: la API de Inspección de URL "proporciona información sobre el estado del índice de una URL, AMP, usabilidad móvil y análisis de resultados enriquecidos" ^[2].

La guía de coupler.io sobre la API de GSC también enfatiza el uso de index.inspect para mantener un sitio saludable. Afirma que la API "ofrece información detallada sobre si la URL está indexada, cualquier error encontrado y posibles áreas de mejora." ^[61]. En la práctica, los desarrolladores usan esto para integrar los hallazgos de Search Console en sus propios paneles o procesos de control de calidad. Por ejemplo, después de un despliegue del sitio, podrías inspeccionar automáticamente un puñado de páginas críticas; si alguna muestra errores, puedes pausar y solucionar los problemas antes de que afecten el tráfico.

Cuotas importantes: La Inspección de URL también tiene sus propias cuotas (ver Tabla 1, arriba, y la documentación de Google ^[34]). Está limitada por tasa (por ejemplo, 600 consultas por minuto por sitio) porque inspeccionar una URL puede ser relativamente costoso. Las inspecciones masivas de miles de URLs pueden alcanzar esos límites, por lo que los scripts a menudo se auto-limitan (o distribuyen los trabajos durante el tiempo de inactividad).

Limitaciones y notas

Aunque potente, la API de Inspección de URL tiene algunas advertencias. Inspecciona solo una URL a la vez (no hay un endpoint de consulta masiva), y cada llamada devuelve datos solo para esa URL. No hay un endpoint para decir "inspeccionar todas las páginas bajo esta ruta"; el llamante debe recorrer las URLs. Además, los campos de "usabilidad móvil" han sido deprecados en la nueva API (Google eliminó esta sección), por lo que siempre pueden devolver nulo. Los resultados de AMP y Resultados Enriquecidos solo aparecen si Google detectó el marcado relevante.

Otra limitación: la API inspecciona el estado actual en los sistemas de Google, no un estado "predictivo" o futuro. Si recientemente solucionaste un problema (por ejemplo, eliminaste una etiqueta noindex), deberás solicitar una nueva inspección o esperar a que Google vuelva a rastrear antes de que la respuesta de la API se actualice. Puedes forzar una nueva lectura en vivo usando "inspectionDepth": "FULL", lo que le dice a Google que recupere la página de nuevo (similar a hacer clic en "Probar URL en vivo" en la interfaz de usuario).

En resumen, la API de Inspección de URL es esencialmente un espejo programático de las partes más esenciales de los informes de "Prueba en vivo" y "Cobertura del índice" de Search Console para una sola página. Es invaluable para la auditoría y verificación automatizada del estado de indexación, la configuración canónica y la elegibilidad para resultados enriquecidos.

Casos de uso e integraciones prácticas de datos

Más allá de sus características principales, la API de GSC permite muchos usos avanzados:

• Paneles personalizados: Debido a que la API produce datos numéricos brutos, los analistas los conectan a paneles (Looker Studio, PowerBI, Tableau, etc.) para combinar métricas de búsqueda con análisis internos u otros datos de marketing ^{[43] [10]}. Google incluso proporciona un conector de Data Studio para Search Console, pero la API permite consultas más personalizadas y conjuntos de datos más grandes que el conector incorporado.

- **Análisis histórico:** Al extraer regularmente datos de la API de GSC a BigQuery o una base de datos, se puede realizar un análisis de series temporales y un seguimiento de tendencias a largo plazo. Por ejemplo, a través de BigQuery se puede ejecutar SQL para comparar clics orgánicos entre campañas de marketing. La exportación de BigQuery (a través de la Configuración de Search Console) esencialmente descarga los mismos datos que proporciona la API, pero en un almacén para consultas <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=,country%20where%20the%20search%20originated" title="Highlights: ,country where the search originated" class="citation-link"><sup>[62]</sup></a>. La guía de Analytics Mania muestra exactamente qué campos (fecha, sitio, consulta, dispositivo, impresiones, clics, etc.) terminan en las tablas de BigQuery <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=,country%20where%20the%20search%20originated" title="Highlights: ,country where the search originated" class="citation-link"><sup>[62]</sup></a> <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=tablet%29%20,do%20that%20a%20bit%20later" title="Highlights: tablet) ,do that a bit later" class="citation-link"><sup>[63]</sup></a>, confirmando que coinciden con el conjunto de datos de Search Analytics de la API.

- **Automatización y alertas:** Los desarrolladores suelen escribir scripts que consultan la API según un horario y verifican si hay anomalías. Por ejemplo, si el total de clics de un sitio cae más de un X% en una semana (según lo devuelto por la API), se podría enviar una alerta a los equipos de SEO. O si una llamada a `sitemaps.get` muestra un gran aumento de "errores" para un sitemap, se podría crear un ticket automatizado para investigar la validez del sitemap.

- **Herramientas SEO e integración con CMS:** Muchas herramientas SEO (aparte de Wix) aprovechan la API. Por ejemplo, Screaming Frog SEO Spider puede obtener datos de Search Console para adjuntarlos a sus informes de rastreo, y las herramientas de seguimiento de ranking o investigación de palabras clave a menudo importan datos de consulta a través de la API. Algunas plataformas CMS ofrecen plugins (especialmente WordPress) para mostrar métricas de GSC a los autores del sitio que han iniciado sesión, todo ello utilizando la API de forma subyacente. Esta es una aplicación directa del principio mencionado en el periodismo SEO: *“Las API ya permiten importar datos de Search Console a Screaming Frog […] y, por supuesto, también hay plugins de WordPress que pueden usarla.”* <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20call%20to%20action%20shows,data%20within%20Google%E2%80%99s%20user%20interface" title="Highlights: The call to action shows,data within Google’s user interface" class="citation-link"><sup>[7]</sup></a>.

- **Gestión multisitio:** Las agencias y empresas se benefician al usar la API para gestionar docenas o cientos de sitios desde un sistema central. Dado que la API de Sitios puede listar todas las propiedades y la API de Search Analytics puede recorrerlas, es posible construir un panel de informes unificado o un sistema de monitoreo para todos los sitios de los clientes.

- **Big Data y Machine Learning:** Algunos usuarios avanzados exportan datos de GSC (a través de la API o BigQuery) a plataformas de ML para predecir tendencias SEO. Por ejemplo, entrenar un modelo con dos años de datos de impresiones/posición podría ayudar a identificar qué páginas podrían escalar con contenido actualizado. Aunque la literatura de investigación sobre esto es escasa, es una práctica emergente en la "automatización SEO" que se basa en tener datos de búsqueda completos.

La relevancia de la **API de inspección de URL de Search Console** también está aumentando. Algunas organizaciones la utilizan para auditar su implementación de AMP o datos estructurados a escala. El blog para desarrolladores de Google (verano de 2020) fomentó el uso de las funciones *“Informes de inspección y análisis del sitio”* de la API. En el caso de estudio de Wix, Wix destaca específicamente *“Informes de inspección y análisis del sitio”* como características que sus usuarios utilizaban regularmente para *“solucionar errores de indexación, corregirlos y obtener información sobre los cambios resultantes en el rendimiento.”* <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=,%E2%80%9C" title="Highlights: ,“" class="citation-link"><sup>[52]</sup></a>. Esto indica un flujo de trabajo: ver un error de indexación a través de la API, corregirlo en el CMS y luego medir el cambio de clics/impresiones a través de la API de GSC la semana siguiente.

## Comparación con otros métodos de acceso

Es útil comparar la API de Search Console con otras formas de obtener datos de Search Console:

- **Descarga manual:** La interfaz de usuario permite descargar datos de rendimiento (como CSV o Google Sheets) para hasta 16 meses de historial <a href="https://searchengineland.com/using-google-search-console-to-manage-search-enhancement-validation-errors-and-employing-the-api-312189#:~:text=Downloads%20%26%20GSC%20API" title="Highlights: Downloads & GSC API" class="citation-link"><sup>[6]</sup></a>, pero esto es manual y está limitado a 1.000 filas (o menos, dependiendo de los filtros). Después de la descarga, uno todavía necesita gestionarlos y almacenarlos por sí mismo. Como aconseja Search Engine Land, las descargas manuales de CSV son "lamentablemente inadecuadas" más allá de usos muy simples <a href="https://searchengineland.com/using-google-search-console-to-manage-search-enhancement-validation-errors-and-employing-the-api-312189#:~:text=Downloads%20%26%20GSC%20API" title="Highlights: Downloads & GSC API" class="citation-link"><sup>[6]</sup></a>.

- **Conector de Data Studio:** El conector gratuito de Data Studio de Google para Search Console automatiza las extracciones periódicas de datos de rendimiento en paneles. Tiene la ventaja de no requerir codificación personalizada, pero es algo inflexible (por ejemplo, puede que no admita todos los filtros personalizados o estados de datos recientes) y a menudo solo permite extraer segmentos de datos a la vez. El conector es bueno para paneles rápidos, pero no reemplaza la API para análisis profundos.

- **Exportación masiva (BigQuery):** Google ahora ofrece una exportación masiva a BigQuery para datos de GSC (anunciada en 2020). A diferencia de la API, esta es una descarga de datos unidireccional y programada en BigQuery con un esquema fijo. Captura todos los tipos de búsqueda y los almacena en tablas; todos los campos coinciden con los datos de la API. Esto es efectivamente lo que algunas guías (como Analytics Mania) recomiendan para análisis avanzados <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a> <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=,country%20where%20the%20search%20originated" title="Highlights: ,country where the search originated" class="citation-link"><sup>[62]</sup></a>. La ventaja es que está actualizado y contiene todas las filas; la desventaja es la falta de control inmediato (solo exportación diaria, requiere facturación de BigQuery). En cualquier caso, BigQuery puede tratarse como un sustituto de un almacén de datos para la extracción a través de la API.

- **API de Indexación (Ofertas de empleo y transmisiones en vivo):** Aunque forma parte de la tecnología de búsqueda de Google, la **API de Indexación** (para ofertas de empleo y datos estructurados de transmisiones en vivo) es independiente y tiene un alcance más limitado: solo permite notificar a Google sobre páginas individuales (oferta de empleo/listado o transmisión en vivo) para que las rastree. *No* es una API de datos de búsqueda de propósito general, por lo que queda fuera de nuestro alcance.

- **PageSpeed, Estadísticas de rastreo, etc.:** Otras API de Google (como la API de PageSpeed o la API de Google Analytics) sirven datos diferentes; ninguna de ellas proporciona métricas de búsqueda orgánica. La API de Search Console cubre el rendimiento de búsqueda y la información de índice; para obtener el comportamiento del usuario en las páginas de búsqueda, uno aún la combinaría con Google Analytics.

## Calidad de los datos y muestreo

Un aspecto a tener en cuenta es que GSC (tanto la interfaz de usuario como la API) no siempre muestra datos *completos* de consultas de búsqueda sin procesar. Históricamente, Google ha muestreado o truncado los datos de consulta cuando el número total de consultas distintas es extremadamente grande, mostrando solo la parte superior. El artículo de coupler.io afirma sin rodeos: *“los datos de palabras clave que se obtienen de la API son muestreados. En lugar de dar una imagen completa de cada consulta de búsqueda que realizan los usuarios, la API entrega una porción más pequeña y representativa de los datos.”* <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Keyword%20data%20sampling" title="Highlights: Keyword data sampling" class="citation-link"><sup>[64]</sup></a>. Esto significa que si un sitio tiene millones de consultas distintas, la API (como la interfaz de usuario) podría enviar datos solo para las más significativas. Esto es particularmente importante de recordar al agregar consultas de cola de bajo tráfico; es posible que no se recupere cada consulta individual. El muestreo es similar a lo que ocurre en Google Analytics para los datos de palabras clave de AdWords.

Sin embargo, para las métricas agregadas (clics/impresiones totales), los datos están completos (dentro de la ventana de 16 meses). El muestreo afecta principalmente a *qué consultas* se informan al final de la lista. En la práctica, esto significa que los analistas diligentes deben tratar las listas de consultas informadas como indicativas, no exhaustivas, especialmente para sitios grandes o rangos de tiempo extremadamente largos. Esta limitación proviene del backend de Google y se menciona en múltiples fuentes (tanto en la documentación de Google como en las publicaciones de analistas de Google). Es otra razón por la que combinar datos de GSC con registros del sitio u otras herramientas a veces puede dar una imagen más completa.

## Limitaciones: Lo que la API *no* proporciona

A pesar de su amplitud, la API de Search Console **no** replica todos los informes de la interfaz de usuario. Las cosas importantes *no disponibles* a través de la API incluyen:

- **Informe de enlaces:** La sección "Enlaces" de la interfaz de usuario de Search Console (que muestra enlaces de retroceso externos/internos y dominios de enlace) no es accesible a través de ninguna API de Search Console. No existe un método API oficial para recuperar una lista de enlaces entrantes. (Para eso se necesitan herramientas de terceros como los conjuntos de datos públicos de Google BigQuery o índices de enlaces de terceros).

- **Cobertura (páginas válidas/excluidas):** No hay un endpoint de API para listar qué páginas están *indexadas vs excluidas*, o para obtener el informe completo de cobertura de índice. Se puede inferir algo de esto usando la inspección de URL en cada página, pero no hay una cobertura/exportación masiva. (La interfaz de usuario de Google muestra "Total de páginas indexadas" pero no la lista completa).

- **Informes de usabilidad móvil/acciones manuales/resultados enriquecidos:** Las secciones de la interfaz de usuario bajo "Mejoras" (usabilidad móvil, AMP, problemas de datos estructurados) y "Seguridad y acciones manuales" no tienen una API directa. Debe depender de escaneos del sitio o verificaciones manuales (excepto que la inspección de URL puede revelar algunos errores página por página).

- **Datos de grupos personalizados:** Si ha configurado, por ejemplo, un conjunto de propiedades (grupos de URL) o comparaciones de Search Analytics, la API no tiene métodos especiales para esas características personalizadas de la interfaz de usuario.

- **Datos históricos más allá de 16 meses:** Como se señaló, la API solo puede recuperar los últimos 16 meses. Si su propiedad de Search Console tenía datos más antiguos (antes de que Google implementara la política de retroceso de 16 meses), esos datos más antiguos no son accesibles a través de la API.

- **Sintaxis de consulta:** La API no permite consultas de forma libre arbitrarias o aritmética como una base de datos. Debe usar los filtros y dimensiones proporcionados, o agregar externamente. En particular, no puede hacer que la API calcule una métrica personalizada más allá del CTR y la posición promedio (no hay campos adicionales como "diferencia de ranking promedio").

Estas limitaciones significan que la API debe verse como un complemento, no como un reemplazo total, de toda la funcionalidad de GSC. Proporciona los "elementos esenciales" (métricas de rendimiento, estado de URL, sitemaps), pero cosas como el descubrimiento de enlaces de retroceso o las alertas de acciones manuales aún requieren otras herramientas o la interfaz de usuario web.

## Casos de estudio y uso en el mundo real

### Integración Wix y Google
Un ejemplo destacado del uso de la API de Search Console es la asociación de Google con Wix (una importante plataforma de creación de sitios web). A finales de 2023, Google publicó un caso de estudio que describe cómo Wix integró los datos de Search Console directamente en su panel de control <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20collaboration%20between%20Google%20and,millions%20of%20Wix%20users%20globally" title="Highlights: The collaboration between Google and,millions of Wix users globally" class="citation-link"><sup>[46]</sup></a>. El caso de estudio destaca que **más de 2 millones de sitios Wix** conectaron sus cuentas de Search Console a través de la nueva integración de Wix <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=,%E2%80%9C" title="Highlights: ,“" class="citation-link"><sup>[52]</sup></a>. Wix expuso características como *“Informes de inspección y análisis del sitio”* dentro de su propia interfaz de usuario, aprovechando la API en segundo plano. Los resultados fueron significativos: los sitios que utilizaron estas nuevas características impulsadas por la API experimentaron un aumento promedio del **+15% en el tráfico de búsqueda** durante un año, y un 24% más de valor bruto de producto para los sitios de comercio electrónico en comparación con sitios similares sin la integración <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20case%20study%20reports%20that,the%20course%20of%20one%20year" title="Highlights: The case study reports that,the course of one year" class="citation-link"><sup>[4]</sup></a>. Esto demuestra cómo empaquetar las capacidades de la API en una interfaz fácil de usar puede mejorar de forma medible los resultados de SEO.

La **implicación** de tales casos de estudio es que Search Console está pasando de ser un SaaS independiente de Google a un "flujo de datos" que se convierte en parte de plataformas más amplias <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20call%20to%20action%20shows,data%20within%20Google%E2%80%99s%20user%20interface" title="Highlights: The call to action shows,data within Google’s user interface" class="citation-link"><sup>[7]</sup></a>. Como señala un oficial de SEO, *“la API está cambiando la forma en que se accede a los datos de Search Console de Google… se trata menos de iniciar sesión en Search Console y más de usar los datos en la GUI de su elección.”* <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20call%20to%20action%20shows,data%20within%20Google%E2%80%99s%20user%20interface" title="Highlights: The call to action shows,data within Google’s user interface" class="citation-link"><sup>[7]</sup></a>. El ejemplo de Wix insta a otros proveedores de CMS/hosting a "colaborar" con Google para aprovechar este flujo de datos (Google incluso incluyó una llamada a la acción para socios interesados) <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=,%E2%80%9D" title="Highlights: ,”" class="citation-link"><sup>[65]</sup></a>.

### Consultoría SEO y paneles de control
Más allá de las plataformas, los consultores SEO y los equipos de marketing internos utilizan la API en sus flujos de trabajo. Un patrón común es construir un pipeline de informes automatizado: scripts nocturnos o semanales extraen Search Analytics y los envían a una base de datos u hoja de cálculo, los combinan con análisis del sitio y generan gráficos. Por ejemplo, coupler.io (un blog de integración de datos) muestra cómo se pueden conectar los datos de la API de GSC a herramientas como Looker Studio o PowerBI para crear paneles de control en vivo <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Another%20key%20advantage%3F%20With%20the,the%20web%20interface%20doesn%E2%80%99t%20allow" title="Highlights: Another key advantage? With the,the web interface doesn’t allow" class="citation-link"><sup>[43]</sup></a>. Otro profesional (Mike Levin) ilustra el uso de Python y Pandas para exportar datos de GSC a un DataFrame para un análisis posterior (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=,improvements%20for%20significant%20SEO%20gains)). En términos de alto nivel, las organizaciones utilizan la API para alimentar los KPI de SEO a los ejecutivos.

Un gerente de SEO relató que, después de normalizar los datos de la API de GSC con métricas internas, descubrió que *“se pueden solicitar métricas por palabra clave, por URL, incluso URL por palabra clave,”* lo que permite un “conocimiento extremadamente granular de qué palabras clave conducen a qué URL” (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=Following%20that%2C%20we%20need%20to,twist%2C%20you%20can%20ask%20for)). En resumen, cualquier análisis que requiera segmentar y desglosar datos de búsqueda más allá de lo que permite la interfaz de usuario se puede realizar típicamente extrayéndolos de la API y procesándolos sin conexión.

### Integración con BigQuery y BI
Como se señaló anteriormente, un caso de uso importante es la exportación masiva a BigQuery para el análisis de "big data". La documentación oficial de Google y las guías de terceros describen cómo vincular una propiedad de Search Console a un proyecto de BigQuery. Una vez configurado (en Configuración de Search Console → "Exportación masiva de datos"), los datos de rendimiento de GSC comienzan a transmitirse a tablas predefinidas en BigQuery. Analytics Mania y otros blogs explican el proceso de principio a fin <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a> <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=,country%20where%20the%20search%20originated" title="Highlights: ,country where the search originated" class="citation-link"><sup>[62]</sup></a>. El punto emocionante es que esto hace que *todos* los datos de consultas de búsqueda (dentro de la ventana de 16 meses) estén disponibles para consultas SQL. Por ejemplo, se puede pivotar fácilmente por país o ejecutar JOINs con datos de ingresos internos para evaluar el rendimiento de las consultas en términos comerciales. Este enfoque no era fácilmente posible solo con la API REST (que está orientada a filas y es iterativa); BigQuery lo centraliza.

### Herramientas de auditoría SEO
Varias herramientas de auditoría SEO han integrado la API. Por ejemplo, las populares herramientas Sitebulb y DeepCrawl pueden importar datos de Search Analytics y Cobertura a través de la API para aumentar sus informes de rastreo. Algunas extensiones de Chrome o pequeñas utilidades permiten verificar una página en vivo consultando la API de inspección de índice. El gran número de plugins de WordPress (tanto gratuitos como premium) que se conectan a Search Console subraya su utilidad: los webmasters pueden ver un mini-informe de GSC directamente en su panel de administración de WP. Para muchos propietarios de sitios sin conocimientos técnicos, esta integración a través de la API (ocultando todos los detalles de OAuth detrás de un simple menú de plugin) democratiza el acceso a estas ideas de Google.

### Opiniones de expertos
Los expertos en SEO enfatizan repetidamente que la API es una **“herramienta poderosa para la optimización basada en datos”** <a href="https://developers.google.com/webmaster-tools/v1/searchanalytics/query#:~:text=Developers%20developers.google.com%20%20,filters%20and%20parameters%20to%20analyze" title="Highlights: Developers developers.google.com  ,filters and parameters to analyze" class="citation-link"><sup>[66]</sup></a>. Un artículo de marzo de 2023 (Search Engine Journal) se centra en el papel de la API para habilitar los pipelines de datos. Cita a especialistas de la industria que señalan que la API es ideal para "construir paneles de control SEO personalizados" <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=The%20Google%20Search%20Console%20API,Search%20Console%20account%20and%20more" title="Highlights: The Google Search Console API,Search Console account and more" class="citation-link"><sup>[67]</sup></a> y que *“la mejor manera de obtener información detallada”* es utilizando la API (en lugar de interactuar con la interfaz de usuario) <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Your%20website%20visibility%20is%20the,foundation%20of%20your%20online%20success" title="Highlights: Your website visibility is the,foundation of your online success" class="citation-link"><sup>[68]</sup></a>. Otro gurú del SEO, Neil Patel, tiene tutoriales que demuestran cómo exportar datos de GSC a través de la API a Excel, subrayando que *“la API permite gestionar y analizar datos sin las limitaciones predeterminadas de la interfaz”* <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Sure%2C%20the%20web%20interface%20is,GSC%20API%20comes%20in%20handy" title="Highlights: Sure, the web interface is,GSC API comes in handy" class="citation-link"><sup>[69]</sup></a>. En resumen, los profesionales reconocen que depender de las API (en lugar de exportar manualmente una vez al mes) es la diferencia entre un SEO reactivo y uno proactivo.

## Análisis de datos y evidencia

Esta sección recopila detalles cuantitativos clave y evidencia sobre el uso de la API de GSC. Primero, algunos datos sobre cuotas y rendimiento:

- **Límites de filas:** Google limita la exportación de datos de rendimiento. El documento de soporte establece explícitamente que *“los datos del informe de rendimiento están limitados a 50.000 filas de datos por día por tipo (web, noticias, imagen, etc.) por propiedad.”* <a href="https://support.google.com/webmasters/answer/12919192?hl=en#:~:text=features%2C%20and%20data%20download%20functionality%C2%A0for,per%20property" title="Highlights: features, and data download functionality for,per property" class="citation-link"><sup>[3]</sup></a>. En términos prácticos, si intenta extraer más de 50.000 filas, la API truncará los resultados a &#126;50.000 (ordenados por clics) (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=,pagination%20stops%20at%20some%20point)).

- **Retención de datos:** Como se documenta en la referencia de la API, *“GSC solo conserva 16 meses de datos de rendimiento.”* (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=,to%20store%20it%20elsewhere%20historically)). Por lo tanto, la fecha **más antigua** que puede consultar es de hace 16 meses. Si los analistas necesitan un historial más antiguo, deben haberlo guardado ellos mismos.

- **Latencia de datos:** Se observa que los datos de rendimiento están disponibles con un retraso de aproximadamente 2 días (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=,but%20marked%20as%20fresh%20data)). La guía de BigQuery de Analytics Mania destaca cómo la `data_date` en las tablas exportadas siempre tiene un retraso de 2 días (la guía advierte explícitamente que *“los datos de Google Search Console están disponibles con un retraso de dos días…”* <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=,country%20where%20the%20search%20originated" title="Highlights: ,country where the search originated" class="citation-link"><sup>[62]</sup></a>). Esto coincide con la experiencia del usuario: las consultas sobre la fecha de ayer pueden no tener valores todavía.

- **Cuotas de la API:** Utilizando el documento oficial de Límites de Uso <a href="https://developers.google.com/webmaster-tools/limits#:~:text=%2A%20Per,40%2C000%20QPM" title="Highlights: * Per,40,000 QPM" class="citation-link"><sup>[33]</sup></a> y el resumen de Coupler <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Feature%20%20%7C%20Per,20%20QPS%3B%C2%A0200%20QPM" title="Highlights: Feature  | Per,20 QPS; 200 QPM" class="citation-link"><sup>[32]</sup></a>, tabulamos:

  | **Recurso**        | **QPM//QPD por sitio**        | **QPM//QPD por proyecto**    | **QPS/QPM por usuario** |
  |--------------------|-------------------------------|------------------------------|-------------------------|
  | Análisis de búsqueda | 1.200 QPM por sitio           | 40.000 QPM; 30.000.000 QPD   | 1.200 QPM por usuario   |
  | Inspección de URL  | 600 QPM; 2.000 QPD por sitio  | 15.000 QPM; 10.000.000 QPD   | (–)                     |
  | Otros (Sitios, etc.) | (N/A por sitio)               | 100.000.000 QPD              | 20 QPS; 200 QPM por usuario |

  *Fuente de datos: documentación de la API de Google <a href="https://developers.google.com/webmaster-tools/limits#:~:text=%2A%20Per,40%2C000%20QPM" title="Highlights: * Per,40,000 QPM" class="citation-link"><sup>[33]</sup></a> <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Feature%20%20%7C%20Per,20%20QPS%3B%C2%A0200%20QPM" title="Highlights: Feature  | Per,20 QPS; 200 QPM" class="citation-link"><sup>[32]</sup></a>.*

- **Datos de la API vs. la Interfaz de Usuario (UI):** Una comparación concreta: la UI solo muestra las “1000 consultas principales”, pero la API (a través de Google Sheets) puede generar hasta 25.000 filas (aproximadamente 150 días de consultas en una sola extracción) <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a>. BigQuery permite “todos los datos sin procesar”. Así, en efecto, los analistas pueden recuperar 25 veces más consultas de una sola vez de lo que permite la UI, como se documenta <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a>. Esto no es una cita de un conjunto de datos externo, sino declaraciones autorizadas del propio consejo de Google: *“la interfaz solo muestra las 1.000 consultas de búsqueda principales”* <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a> frente a *“la API de GSC dentro de Google Sheets permite acceder hasta 25.000 filas”* <a href="https://www.analyticsmania.com/post/query-google-search-console-data-in-bigquery/#:~:text=Google%20Search%20Console%20is%20one,view%20of%20your%20site%E2%80%99s%20performance" title="Highlights: Google Search Console is one,view of your site’s performance" class="citation-link"><sup>[10]</sup></a>.

El estudio de caso de Wix proporciona **datos de resultados** sólidos sobre el uso de la API. Informa que, después de habilitar la integración de la API, los usuarios de Wix experimentaron en promedio un **aumento del 15% en el tráfico de búsqueda** durante un año <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20case%20study%20reports%20that,the%20course%20of%20one%20year" title="Highlights: The case study reports that,the course of one year" class="citation-link"><sup>[4]</sup></a>. Además, en la función de comercio: *“Los sitios de comercio electrónico experimentaron un aumento del 24% en el Valor Bruto del Producto en comparación con sitios de comercio electrónico de Wix similares que no utilizaron las integraciones de la API de Search Console.”* <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20case%20study%20reports%20that,the%20course%20of%20one%20year" title="Highlights: The case study reports that,the course of one year" class="citation-link"><sup>[4]</sup></a>. Estas cifras ilustran el impacto de alto nivel de hacer que los datos de búsqueda sean accionables. Si bien hay que tener en cuenta otros factores de confusión, un aumento del tráfico del +15% es un tamaño de efecto grande y consistente con proporcionar a los propietarios de sitios información directa basada en datos (por ejemplo, al detectar problemas de indexación o consultas perdidas a través de la API).

Finalmente, los comentarios de expertos confirman el valor de la API. Un artículo de Search Engine Journal califica la API como *“una herramienta poderosa para la optimización basada en datos”* <a href="https://developers.google.com/webmaster-tools/v1/searchanalytics/query#:~:text=Developers%20developers.google.com%20%20,filters%20and%20parameters%20to%20analyze" title="Highlights: Developers developers.google.com  ,filters and parameters to analyze" class="citation-link"><sup>[66]</sup></a>, y señala que es ideal para *“construir paneles de control SEO personalizados”* mediante la “recopilación de información detallada” <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Your%20website%20visibility%20is%20the,foundation%20of%20your%20online%20success" title="Highlights: Your website visibility is the,foundation of your online success" class="citation-link"><sup>[68]</sup></a> <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Another%20key%20advantage%3F%20With%20the,the%20web%20interface%20doesn%E2%80%99t%20allow" title="Highlights: Another key advantage? With the,the web interface doesn’t allow" class="citation-link"><sup>[43]</sup></a>. Otro resumen profesional aconseja explícitamente a los desarrolladores que utilicen la API para tareas repetitivas: *“cuando sea posible, es preferible escribir aplicaciones para estos propósitos más avanzados… usar la API de Google Search Console v3 puede ahorrarle trabajo.”* <a href="https://searchengineland.com/using-google-search-console-to-manage-search-enhancement-validation-errors-and-employing-the-api-312189#:~:text=Google%20Search%20Console%20API%20v3" title="Highlights: Google Search Console API v3" class="citation-link"><sup>[70]</sup></a>. Por lo tanto, tanto los resultados cuantitativos como la opinión cualitativa de los expertos respaldan firmemente el aprovechamiento de la API de GSC para un análisis exhaustivo del sitio.

## Direcciones Futuras e Implicaciones

El panorama del análisis de búsqueda sigue evolucionando, y la API de Search Console está a la vanguardia de ese cambio. Los desarrollos recientes de Google sugieren un impulso hacia más funciones de exportación e integración de datos:

- **Mejoras en la Infraestructura de la API:** Google ha trabajado en la mejora del rendimiento y la escalabilidad de la API. En 2020, anunciaron *“una actualización de la infraestructura de la API para mejorar el rendimiento a medida que crece la demanda”* <a href="https://developers.google.com/search/blog/2020/12/search-console-api-updates#:~:text=Wednesday%2C%20December%209%2C%202020" title="Highlights: Wednesday, December 9, 2020" class="citation-link"><sup>[71]</sup></a>, y desde entonces han añadido funcionalidades (como datos recientes y filtros de noticias). Las mejoras continuas probablemente significarán un rendimiento aún mejor, más tipos de datos (por ejemplo, posible soporte futuro para nuevas funciones de búsqueda como métricas de rendimiento de *Shopping*), y alcances adicionales para otros informes de la UI (aunque aún no hay anuncios concretos sobre cobertura o enlaces).

- **Mejoras en la Exportación Masiva (BigQuery):** La capacidad de exportación de grandes volúmenes de datos es bastante nueva (2020). Google se está centrando en hacer de Search Console una fuente de datos para los pipelines de análisis. Podemos esperar que la exportación a BigQuery se vuelva más rica (quizás incluyendo datos más completos con el tiempo) y más automatizada. Por ejemplo, Google podría eventualmente exportar métricas de Core Web Vitals o Page Experience de forma masiva cuando esas funciones se implementen por completo. Si Search Console introduce nuevos datos en la UI (por ejemplo, sobre funciones de búsqueda asistidas por IA), también podría proporcionar acceso a través de la API.

- **Integración con IA y Automatización:** Con la creciente prominencia de la IA, uno puede imaginar la combinación de datos de la API de Search Console con el aprendizaje automático. Por ejemplo, una IA podría analizar datos de consultas y clasificaciones para recomendar cambios en el contenido. La guía interna de Google sobre el uso de grandes modelos de lenguaje para SEO insinúa futuras herramientas que combinarán las consultas de Search Console con modelos generativos. Dada la tendencia de Google, es posible que eventualmente proporcionen análisis más sofisticados o información predictiva a través de la API (aunque esto es especulativo).

- **Estandarización y Crecimiento del Ecosistema:** El caso de Wix muestra a Google cortejando activamente a los CMS/creadores de sitios web para que integren Search Console a través de la API. Es posible que veamos más conectores listos para usar (WordPress, Shopify, etc.) que faciliten la disponibilidad de los datos de la API. Esto podría estandarizar la forma en que los datos de búsqueda fluyen hacia las plataformas de marketing (por ejemplo, CRMs, plataformas de anuncios). Además, los actores de la industria podrían construir paneles de control SEO combinados que se conecten a múltiples fuentes de datos, siendo la API de Search Console una fuente crítica.

- **Cobertura de Datos Faltantes:** En los foros de desarrolladores, los propietarios de sitios solicitan con frecuencia acceso a informes de cobertura o informes de enlaces a través de la API. Google hasta ahora no los ha expuesto, posiblemente debido a razones técnicas o de privacidad. Sin embargo, como implicación a largo plazo, la presión para que todos los datos lógicos estén disponibles a través de la API podría aumentar. Es posible que futuras versiones de la API incluyan información parcial de cobertura (por ejemplo, un método para obtener el “recuento de páginas indexadas”) o datos de enlaces (quizás limitados a cuentas de Search Console conectadas por motivos de privacidad). Si tales expansiones ocurrieran, la API se volvería aún más completa.

- **Search Console como Flujo de Datos:** En general, la tendencia es que los datos de Search Console se están convirtiendo en un flujo de datos (una visión mencionada en la serie de casos y sugerencias de Google). En lugar de un producto independiente que se visita, es un servicio que alimenta otras herramientas y flujos de trabajo. Esto coincide con la estrategia más amplia de Google de proporcionar APIs ricas en datos (como la API de Analytics, la API de Ads). Para los usuarios, esto significa que el SEO se volverá cada vez más impulsado por datos y automatizado. Veremos integraciones de “configurar y olvidar” donde las métricas de Search Console activan directamente acciones (por ejemplo, correcciones canónicas, actualizaciones de contenido) sin intervención manual.

## Conclusión

La API de Google Search Console desbloquea una gran cantidad de información para webmasters y desarrolladores. Hace que los datos de rendimiento de búsqueda de Google sean **totalmente programables**: se pueden recuperar clics, impresiones, CTR y posiciones por consulta, página, país o dispositivo; gestionar los sitemaps y las propiedades del sitio; y verificar el estado de indexación de URL a escala. Este nivel de acceso ha transformado los flujos de trabajo de SEO. Estudios de caso como la integración de Wix muestran un valor comercial real: metaestudios informan ganancias de tráfico de dos dígitos al usar la API <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20case%20study%20reports%20that,the%20course%20of%20one%20year" title="Highlights: The case study reports that,the course of one year" class="citation-link"><sup>[4]</sup></a>. El consenso de los expertos es claro: la API es esencial para cualquier pipeline de datos SEO serio, permitiendo informes personalizados y automatizaciones que serían imposibles a través de la GUI <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=The%20API%20allows%20you%20to,indexing%20problems%20quickly%20and%20efficiently" title="Highlights: The API allows you to,indexing problems quickly and efficiently" class="citation-link"><sup>[8]</sup></a> <a href="https://searchengineland.com/using-google-search-console-to-manage-search-enhancement-validation-errors-and-employing-the-api-312189#:~:text=Google%20Search%20Console%20API%20v3" title="Highlights: Google Search Console API v3" class="citation-link"><sup>[70]</sup></a>.

Por supuesto, la API tiene sus límites: cuotas, antigüedad de los datos y características faltantes de la UI (notablemente los backlinks y los informes completos de cobertura) deben ser gestionados. Pero los usuarios han desarrollado estrategias (por ejemplo, dividir consultas, almacenar instantáneas históricas, combinar con BigQuery) para trabajar dentro de estas restricciones (Source: [mikelev.in](https://mikelev.in/futureproof/google-search-console-api/#:~:text=,but%20marked%20as%20fresh%20data)) <a href="https://support.google.com/webmasters/answer/12919192?hl=en#:~:text=features%2C%20and%20data%20download%20functionality%C2%A0for,per%20property" title="Highlights: features, and data download functionality for,per property" class="citation-link"><sup>[3]</sup></a>. Nuestro estudio exhaustivo muestra que la API es tanto amplia como profunda: casi todos los datos críticos de Search Console pueden ser accedidos, analizados y procesados mediante código.

De cara al futuro, Google parece comprometido a tratar Search Console como un servicio de datos exportable. Han estado mejorando la infraestructura de la API y añadiendo funciones (datos recientes, filtros de noticias/Discover) <a href="https://developers.google.com/search/blog/2020/12/search-console-api-updates#:~:text=Fresh%20data%20and%20news%20filter,in%20the%20Search%20Console%20API" title="Highlights: Fresh data and news filter,in the Search Console API" class="citation-link"><sup>[41]</sup></a>. Anticipamos nuevas expansiones (aunque graduales) para hacer del análisis de búsqueda una parte aún más integrada del ecosistema de gestión web. Por ahora, cualquier organización que se tome en serio el SEO debería estar aprovechando esta API. Como dijo un especialista en marketing SEO, “no hay mejor manera de obtener una gran cantidad de información” que construyendo herramientas alrededor de la API de Google Search Console <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=Your%20website%20visibility%20is%20the,foundation%20of%20your%20online%20success" title="Highlights: Your website visibility is the,foundation of your online success" class="citation-link"><sup>[68]</sup></a>.

**Fuentes:** Documentación autorizada de Google Developers y Ayuda de Search Console <a href="https://developers.google.com/webmaster-tools/v1/searchanalytics/query#:~:text=Query%20your%20search%20traffic%20data,of%20one%20or%20more%20days" title="Highlights: Query your search traffic data,of one or more days" class="citation-link"><sup>[21]</sup></a> <a href="https://developers.google.com/webmaster-tools/v1/sitemaps#:~:text=,download%20date%2C%20and%20error%2Fwarning%20counts" title="Highlights: ,download date, and error/warning counts" class="citation-link"><sup>[12]</sup></a> <a href="https://developers.google.com/webmaster-tools/v1/sites#:~:text=Property%20name%20%20,Acceptable%20values%20are" title="Highlights: Property name  ,Acceptable values are" class="citation-link"><sup>[15]</sup></a>, publicaciones del blog de Google Search Central <a href="https://developers.google.com/search/blog/2020/12/search-console-api-updates#:~:text=Fresh%20data%20and%20news%20filter,in%20the%20Search%20Console%20API" title="Highlights: Fresh data and news filter,in the Search Console API" class="citation-link"><sup>[41]</sup></a> <a href="https://developers.google.com/search/blog/2015/05/announcing-google-search-console-new#:~:text=Announcing%20Google%20Search%20Console%20,the%20new%20Webmaster%20Tools" title="Highlights: Announcing Google Search Console ,the new Webmaster Tools" class="citation-link"><sup>[9]</sup></a>, artículos de soporte <a href="https://support.google.com/webmasters/answer/12919192?hl=en#:~:text=The%20Search%20Console%20API%20provides,web" title="Highlights: The Search Console API provides,web" class="citation-link"><sup>[1]</sup></a> <a href="https://support.google.com/webmasters/answer/12919192?hl=en#:~:text=The%20API%20is%20free%2C%20though,against%20a%20smallish%20data%20set" title="Highlights: The API is free, though,against a smallish data set" class="citation-link"><sup>[11]</sup></a>, y análisis de la industria SEO <a href="https://www.searchenginejournal.com/google-case-study-shows-direction-of-search-console-with-apis/507250/#:~:text=The%20case%20study%20reports%20that,the%20course%20of%20one%20year" title="Highlights: The case study reports that,the course of one year" class="citation-link"><sup>[4]</sup></a> <a href="https://blog.coupler.io/google-search-console-api/amp/#:~:text=The%20API%20allows%20you%20to,indexing%20problems%20quickly%20and%20efficiently" title="Highlights: The API allows you to,indexing problems quickly and efficiently" class="citation-link"><sup>[8]</sup></a> <a href="https://searchengineland.com/using-google-search-console-to-manage-search-enhancement-validation-errors-and-employing-the-api-312189#:~:text=Downloads%20%26%20GSC%20API" title="Highlights: Downloads & GSC API" class="citation-link"><sup>[6]</sup></a> fueron utilizadas a lo largo del texto. Cada afirmación anterior está respaldada por al menos una de estas fuentes creíbles.