¿Cómo uso la API de Google Search Console?

Q: ¿Cómo uso la API de Google Search Console?

Configura un proyecto de Cloud, habilita la API, autoriza con OAuth y consulta datos de rendimiento, inspección de URL y sitemaps. Estos son los pasos y las cuotas.

Crea un proyecto en la consola de Google Cloud, habilita la Google Search Console API, crea credenciales OAuth 2.0 e inicia sesión con una cuenta de Google que tenga acceso a la propiedad. A partir de ahí puedes enviar solicitudes a cuatro recursos: Search Analytics para clics, impresiones, CTR y posición; URL Inspection para el estado de indexación; Sitemaps; y Sites. Las claves de API por sí solas no funcionan: cada llamada necesita un token de OAuth, y las cuotas limitan cuántos datos puedes pedir.

Qué cubre la API y qué no

Recurso	Métodos	Para qué sirve
Search Analytics	`query`	Filas de rendimiento por consulta, página, país, dispositivo, apariencia en búsqueda, fecha u hora
URL Inspection	`index.inspect`	La versión indexada de una URL: cobertura, último rastreo, canónicas
Sitemaps	`list`, `get`, `submit`, `delete`	Gestionar los sitemaps que ha enviado una propiedad
Sites	`list`, `get`, `add`, `delete`	Las propiedades de la cuenta con la sesión iniciada

Eso es toda la API. Los enlaces, las estadísticas de rastreo, el informe de indexación de páginas y el informe de Core Web Vitals no tienen endpoint, así que solo están disponibles en la interfaz de Search Console. URL Inspection muestra lo que hay en el índice de Google, no una prueba en vivo de la página.

Configura el acceso

En la consola de Google Cloud, crea o elige un proyecto.
Habilita la Google Search Console API en ese proyecto.
Configura la pantalla de consentimiento de OAuth y crea un ID de cliente de OAuth.
Solicita un ámbito: https://www.googleapis.com/auth/webmasters.readonly para leer, o https://www.googleapis.com/auth/webmasters para poder también enviar o eliminar sitemaps.
Inicia sesión con una cuenta que tenga permisos sobre la propiedad. Para leer datos de rendimiento hace falta como mínimo acceso de lectura; la API ve exactamente lo que ve esa cuenta.

Tu primera consulta a Search Analytics

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

El sitio va en la ruta, codificado como URL: sc-domain:example.com para una propiedad de dominio, o el prefijo exacto con su barra final, como https://www.example.com/, para una propiedad de prefijo de URL. Los campos más importantes:

Las fechas son inclusivas y se expresan en hora del Pacífico.
type es web por defecto; los demás valores son image, video, news, googleNews y discover. Cada uno requiere su propia solicitud.
Los filtros van en dimensionFilterGroups, con operadores que van desde equals y contains hasta includingRegex y excludingRegex (sintaxis RE2).
rowLimit va de 1 a 25,000 (por defecto 1,000); startRow sirve para paginar el resto.
dataState es final por defecto; all añade días recientes aún sin consolidar y hourly_all funciona con la dimensión hour.

Cada fila devuelve keys, clicks, impressions, ctr (de 0 a 1) y position, ordenadas por clics salvo que agrupes por fecha.

Los límites que condicionan tu código

50,000 filas por día y tipo de búsqueda. Pagina con startRow en bloques de 25,000 y detente cuando la respuesta llegue vacía. Para obtener el máximo de datos, consulta un día cada vez.
Cuota de carga. Agrupar o filtrar por página y consulta a la vez es la solicitud más costosa, y los rangos de fechas largos cuestan más que los cortos. Si superas la cuota a corto plazo, Google te pide esperar 15 minutos.
Frecuencia de solicitudes. 1,200 consultas por minuto por sitio y por usuario; 40,000 por minuto y 30,000,000 al día por proyecto.
Cuota de URL Inspection. 2,000 inspecciones al día y 600 por minuto para cada propiedad.
16 meses de historial, y los datos suelen estar disponibles dos o tres días después de que termina el día.
Las filas no suman los totales. Las consultas poco frecuentes se omiten en las filas a nivel de consulta, y al agrupar por página las impresiones se cuentan de forma distinta que al agrupar por propiedad, así que obtén los totales de una solicitud sin la dimensión de consulta.

Errores comunes

Usar http:// cuando la propiedad es https://, o dejar fuera la barra final, provoca un error de permisos aunque la cuenta tenga acceso.
En URL Inspection se rechaza cualquier URL que quede fuera de la propiedad: la URL debe estar dentro del siteUrl que pasas.
Un mes agrupado por consulta y página en una sola llamada devuelve solo las filas principales. Las solicitudes diarias devuelven más.

Cómo te ayuda AutoPSEO

Si prefieres no mantener OAuth ni la paginación, AutoPSEO se conecta mediante el inicio de sesión con Google y expone los mismos datos a través de su propia REST API en /v1 (con un documento OpenAPI 3.1) y de un servidor MCP, autorizados con una clave de API de Cuenta → Claves de API. Hay claves de solo lectura, el endpoint de search analytics devuelve hasta 5,000 filas por llamada, y las herramientas de URL Inspection de la aplicación llevan la cuenta por ti de la cuota de 2,000 al día de Google. Consulta MCP y claves de API. Para conservar los datos más allá de 16 meses sin escribir un pipeline, consulta cuánto tiempo conserva Search Console los datos.

Fuentes: la referencia de la API de Google, el método query de Search Analytics, los límites de uso, cómo obtener todos tus datos y la guía de autorización.