Pide una auditoría

Inicio / RoloPedia / SEOpedia

SEOpedia · SEO Técnico · Herramientas

API de Google Search Console

En inglés: Google Search Console API

La API de Google Search Console es la interfaz de programación que permite consultar de forma automatizada los datos de rendimiento, sitemaps e inspección de URLs de Search Console. Evita la extracción manual desde la interfaz web y permite trabajar con mucho más volumen de datos. Ofrece datos de rendimiento (clics, impresiones, CTR y posición media) con filtros por consulta, página, país, dispositivo y fecha; gestión de sitemaps y propiedades; e inspección de URLs (estado de indexación, canónica elegida, usabilidad). No expone todos los informes de la interfaz: enlaces, Core Web Vitals o acciones manuales siguen fuera de la API. Es especialmente valiosa para agencias que gestionan muchos clientes, grandes sitios con reporting automatizado y análisis que cruzan GSC con otras fuentes (GA4, crawls, herramientas de terceros). La interfaz web solo muestra 1.000 filas; la API devuelve hasta 25.000 filas por petición y permite paginar, aunque Google no garantiza todas las combinaciones de consulta (se omiten las anonimizadas y existe un tope diario de filas). Requiere autenticación OAuth 2.0 o cuenta de servicio con permisos en la propiedad.

Ejemplos

  • Script de reporting automatizado: un script en Python con la librería oficial extrae los datos de rendimiento diarios, los procesa con pandas, detecta oportunidades (consultas con muchas impresiones y CTR bajo para su posición) y envía un informe por correo. Sustituye horas de trabajo manual cada semana (ejemplo hipotético).
  • Análisis multipropiedad: una agencia consulta la API para todos sus clientes, agrega métricas de visibilidad, detecta caídas bruscas de una semana a otra y lanza alertas automáticas (ejemplo hipotético).
  • Exportación masiva a BigQuery + Looker Studio: para históricos largos y sin límites de filas, activar la exportación masiva de Search Console a BigQuery y montar encima los paneles de Looker Studio.

Consejos prácticos

  • Usa bibliotecas oficiales: google-api-python-client (Python), googleapis (Node.js) - manejan autenticación y rate limiting
  • Gestiona las cuotas: la API limita peticiones por minuto y por día; usa backoff exponencial y consulta la documentación oficial de límites
  • Segmenta las consultas grandes: en sitios con millones de URLs, divide por tipo de página o por fecha y pagina con startRow
  • Combina con BigQuery: la exportación masiva de Search Console (disponible desde 2023) da datos diarios sin los límites de filas de la API
  • Casos de uso prácticos: 1) Detectar oportunidades quick wins (posiciones 5-15 con alto volumen), 2) Monitorear rankings 24/7, 3) Correlacionar cambios GSC con deploys de código
  • Herramientas útiles: el complemento Search Analytics for Sheets y notebooks de Python publicados en GitHub

Términos relacionados

Jorge J. Rolo

SEO & AI Search Manager en Flat 101. Consultor SEO técnico.