API de Search Console: cómo obtener acceso y qué datos devuelve
Por Toy Wen Da, Cofundador · · 6 min de lectura
Traducido del original en inglés. Léelo en inglés
La API de Search Console es la interfaz programática de Google para acceder a los mismos datos que ves en Google Search Console: clics, impresiones, posición y estado de indexación, pero a través de código en lugar del panel. Lo primero que debes hacer es habilitarla en Google Cloud Console y crear credenciales. Después, autorízala sobre la propiedad que ya tienes en Search Console.
Antes de construir algo a medida, comprueba si de verdad necesitas acceso directo a la API. La función de tráfico del sitio de SearchBlueprint ya reúne en una sola vista tus datos de Search Console, junto con Google Analytics y las visitas de rastreadores de IA. Para la mayoría de los propietarios de sitios web, eso responde a la pregunta "¿qué está pasando con mis clics y mis impresiones?" sin escribir una sola línea de código.
Qué hace realmente la API de Search Console
Es una API REST publicada por Google que replica la mayor parte de lo que hay en el panel de Search Console. Incluye el rendimiento en búsquedas (consultas, páginas, países, dispositivos), el estado de los sitemaps y los resultados de la inspección de URL. La llamas desde un script, un servicio de backend o una herramienta. Devuelve JSON estructurado en lugar de una pantalla que tengas que leer a mano.
No te da nada que la propia Search Console no te muestre ya. Su valor está en el volumen y la automatización: extraer años de datos, combinar varias propiedades o actualizar un informe cada mañana sin que nadie abra una pestaña del navegador.
Cómo obtener acceso: clave de API, OAuth y habilitar la API
Una simple clave de API no es suficiente. Los endpoints de Search Analytics de Google necesitan un usuario o una cuenta de servicio autorizados sobre la propiedad concreta. Esto se debe a que los datos están vinculados a quien verificó la titularidad. Esta es la secuencia, tal como funciona en la consola actual.
Paso 1: habilita la API en Google Cloud Console
Ve a Google Cloud Console, selecciona o crea un proyecto, abre el menú APIs & Services y luego Library. Busca "Google Search Console API", haz clic en ella y después en Enable.
Paso 2: crea las credenciales
Sin salir de APIs & Services, abre Credentials y luego Create Credentials. Para scripts y tareas de servidor a servidor, elige una Service Account y descarga su clave JSON. Para una aplicación que actúa en nombre de un usuario con sesión iniciada, elige en su lugar un OAuth client ID.
Paso 3: concede acceso en Search Console
La API solo ve las propiedades a las que tiene acceso la identidad autenticada. Si creaste una cuenta de servicio, copia su dirección de correo y añádela como usuario en Search Console. Hazlo en Settings > Users and permissions. Concede como mínimo acceso Full o Restricted, según necesite enviar sitemaps o solo leer datos.
Paso 4: haz tu primera llamada
Con las credenciales en la mano, autentícate y llama al método query de Search Analytics. Indica una fecha de inicio, una fecha de fin y las dimensiones (consulta, página, país, dispositivo). Este es también el punto en el que suele aparecer un desajuste de verificación. Si la cuenta de servicio no puede ver la propiedad, normalmente significa que hay que revisar la propia verificación de Search Console. Conviene corregirlo en el origen antes de depurar la llamada a la API.
Qué puedes extraer: los endpoints de un vistazo
| Endpoint | Qué devuelve | Uso típico |
|---|---|---|
| Search Analytics query | Clics, impresiones, CTR y posición por consulta/página/país/dispositivo | Paneles de posicionamiento y tráfico |
| Sitemaps | Lista, envía o elimina entradas de sitemap | Reenvío automático del sitemap tras una reconstrucción |
| URL Inspection | Estado de indexación, canónica y usabilidad móvil de una URL | Comprobar si una página se indexó tras publicarla |
| Sites | Lista o añade las propiedades a las que puede acceder la cuenta | Herramientas para agencias con varios sitios |
API de Search Console frente a exportación manual y herramientas sin código
| Opción | Ideal para | Esfuerzo de configuración | Principal limitación |
|---|---|---|---|
| Exportación desde la interfaz de Search Console | Una comprobación única y ocasional | Ninguno | Filas limitadas, sin programación ni automatización |
| Llamadas directas a la API | Paneles a medida, desarrolladores | Moderado a alto (OAuth, código) | Tú mantienes la autenticación y el código |
| Wrappers de API sin código | Personas sin perfil técnico que aun así necesitan JSON | Bajo | Cuota mensual, menos control sobre los campos |
| Plataformas de integración (iPaaS) | Productos SaaS que incorporan datos de GSC para sus clientes | Moderado | Pensadas para proveedores, no para los informes de un solo sitio |
Los wrappers sin código existen precisamente para evitar el trabajo con OAuth y los endpoints. Algunos, como el conector de Search Console de NoCodeAPI, convierten las llamadas de Search Analytics y de sitemaps en un único endpoint JSON autenticado. En el otro extremo, proveedores como Paragon ofrecen integraciones nativas de Search Console creadas con aproximadamente un 70% menos de esfuerzo de ingeniería que construir desde cero la lógica de OAuth y de sincronización. Están dirigidos a equipos SaaS que incorporan datos de Search Console dentro de su propio producto, no a quien solo quiere ver sus propias cifras.
Cuándo bastan las herramientas gratuitas y cuándo no
La interfaz de Search Console basta cuando revisas una sola URL o respondes una pregunta puntual ("¿se indexó esta página?"). También sirve para echar un vistazo a las principales consultas del mes pasado. No está pensada para nada recurrente ni para varias propiedades.
La API (o una herramienta construida sobre ella) compensa cuando necesitas:
- Un informe programado que se actualice sin que nadie abra Search Console
- Datos de más propiedades de las que puedes revisar a mano en pestañas
- Un historial más amplio del que la interfaz muestra con comodidad
- Datos de búsqueda combinados con otras fuentes. Conviene además conocer la diferencia real entre Search Console y Analytics, ya que responden a preguntas distintas y ninguna sustituye a la otra
Errores comunes
- Usar una clave de API en lugar de OAuth o una cuenta de servicio. Las llamadas a Search Analytics fallarán sin la autorización adecuada, por válida que parezca la clave.
- Olvidar añadir la cuenta de servicio como usuario en Search Console. La credencial de la API y el permiso sobre la propiedad son dos pasos distintos.
- Suponer que la API devuelve más historial que la interfaz. Ambas se nutren de los mismos datos; la ventaja de la API es la automatización, no meses extra de registros.
- Fijar a mano los rangos de fechas y las dimensiones. Las consultas que no paginan correctamente truncarán los resultados en silencio en sitios con mucho tráfico.
Preguntas frecuentes
¿Tengo que pagar por la API de Search Console?
No. La API en sí es gratuita dentro de los límites de cuota estándar de Google; solo pagas si construyes o compras una herramienta sobre ella.
¿Cuál es la diferencia entre una clave de API y OAuth en Search Console?
Una clave de API identifica un proyecto. OAuth (o una cuenta de servicio) identifica y autoriza a un usuario o una cuenta concretos sobre una propiedad. Los datos de Search Analytics requieren esto último.
¿Puedo usar la API de Search Console sin programar?
Sí, mediante conectores sin código que envuelven la API en un endpoint JSON más sencillo. Aun así tendrás que autenticarte con Google y gestionar una cuenta con ese proveedor.
¿Cuántos datos puedo extraer por solicitud?
La documentación de Google detalla los límites de filas y de cuota de cada método. Las cuentas grandes suelen tener que paginar las solicitudes en lugar de extraerlo todo en una sola llamada.
¿Funciona la API con propiedades que no he verificado?
No. El acceso está vinculado a la titularidad verificada en Search Console. Por eso la credencial que uses debe añadirse primero como usuario de esa propiedad.
Para consultar la referencia técnica completa, incluidas las cuotas y los parámetros de los métodos, consulta la documentación de la API de Search Console de Google.
Comprueba tus cifras antes de construir nada
Si el objetivo es solo tener visibilidad (clics, impresiones y cómo tratan los rastreadores de IA tus páginas), la API de Search Console no es necesaria. Sáltate la configuración de OAuth y míralo ya reunido en la vista de tráfico del sitio de SearchBlueprint. Para tener una visión más amplia de cómo está rindiendo ahora mismo tu sitio en las búsquedas, habla con el equipo. Recibirás un informe de muestra elaborado con los datos de tu propio sitio.
Recursos / Referencias
Fuentes
Sobre el autor
SearchBlueprint investigó, escribió y puntuó este artículo con el mismo flujo de contenido que nuestros clientes usan en sus propios sitios. La puntuación que aparece junto al autor es la que nuestro motor de contenido dio a esta página antes de publicarla. Nada de esto se revisa a mano, y ese es el punto: es el resultado del producto, publicado donde cualquiera puede comprobarlo.