API de Google Search Console para tu propio stack
Los datos de rendimiento de tu Search Console, sobre un endpoint REST limpio.
Lleva clics, impresiones, CTR y posición media — por consulta, página y rango de fechas — directamente desde Google Search Console a tu producto, tu dashboard o tu data warehouse. Conecta GSC una vez dentro de SEOcrawl AI, genera una clave Bearer desde tu panel y llama a la REST /v1 — sin montar tú el OAuth de Google. Es la misma capa de datos canónica que alimenta el MCP de SEOcrawl AI, así que tus cifras siempre cuadran. La cobertura de indexación y la inspección de URL llegan a REST en breve; por MCP ya están disponibles.
Resuelve una propiedad. Consulta tus datos de GSC.
Genera un token Bearer desde tu panel y pásalo en la cabecera Authorization. Resuelve una vez el id de la propiedad de Search Console y luego consulta su rendimiento por REST. La misma clave sirve para la API REST y para el servidor MCP.
URL base
https://api.seocrawl.ai/v1Cabecera Authorization
Authorization: Bearer sca_live_your_token_hereTodas las métricas de Search Console, por REST
Clics, impresiones, CTR y posición media — por consulta, página, rango de fechas y periodo contra periodo. Todos los endpoints van ligados a una propiedad: primero resuelve su id y después lee sus datos de Search Console. Estos grupos de GSC ya están vivos en la v1; la cobertura de indexación y la inspección de URL están hoy en el MCP y llegan a REST a continuación.
Propiedades
Lista las propiedades de Search Console conectadas a tu cuenta. Usa el id de cada propiedad en la ruta de todos los endpoints de GSC.
- GET
/v1/propertiesActivo
Rendimiento
Clics, impresiones, CTR y posición media totales para un rango de fechas — más la variación frente al periodo anterior para esa misma ventana.
- GET
/v1/properties/{id}/gsc/summaryActivo - GET
/v1/properties/{id}/gsc/compareActivo
Consultas
Las consultas de búsqueda por las que apareces, con métricas por consulta — y el histórico diario completo de cualquier keyword.
- GET
/v1/properties/{id}/gsc/top-keywordsActivo - GET
/v1/properties/{id}/gsc/keywords/detailActivo
Páginas
Tus URLs con mejor rendimiento y sus métricas de Search Console — y el desglose diario completo de cualquier página.
- GET
/v1/properties/{id}/gsc/top-pagesActivo - GET
/v1/properties/{id}/gsc/pages/detailActivo
Cobertura de indexación
Lo que Google indexa de verdad: estados de cobertura e histórico de indexación. Hoy disponible en el MCP; los endpoints REST están en despliegue.
- GET
/v1/properties/{id}/indexation/summaryPronto
Inspección de URL
Inspección URL a URL — cobertura, último rastreo y estado de indexación de una página concreta. Ya disponible por MCP; REST va después.
- GET
/v1/properties/{id}/url-inspectionPronto
Datos reales de Search Console, pensados para productos
Tu rendimiento real en Google Search Console — no estimaciones de terceros — sobre una API REST limpia, con auth Bearer y límites de uso, compartiendo una única capa de datos canónica con el MCP para que las cifras nunca se contradigan.
Directo desde Search Console
Clics, impresiones, CTR y posición media extraídos de tu propia propiedad de GSC — las cifras reales que reporta Google, no estimaciones modeladas ni scrapeadas. Recursos predecibles, verbos estándar, JSON tipado y errores conformes a los RFC.
Sin montar el OAuth de Google
Conecta Search Console una vez dentro de SEOcrawl AI y léelo con una única clave Bearer sca_live_. Olvídate del proyecto en Google Cloud, la pantalla de consentimiento y el refresco de tokens: crea y revoca claves desde tu panel en segundos.
Una única capa de datos canónica
Los endpoints REST de GSC y las herramientas GSC del MCP son hermanos sobre el mismo proveedor, con paridad testeada en CI. Tu dashboard y tus agentes de IA ven siempre los mismos clics, impresiones y posiciones.
Granularidad por consulta y por página
Lee los totales de una propiedad o baja al detalle: top de consultas, top de páginas, la tendencia diaria de una keyword o el histórico de una URL — las mismas dimensiones que ves en Search Console, accesibles por HTTP.
Comparativa de periodos incluida
Pide un rango (last_7_days, last_28_days, last_3_months, last_year) o fechas from/to explícitas y recibe la comparación entre periodos de serie — sin una segunda llamada ni cálculos de fechas en cliente para cuadrar las variaciones.
Límites de uso documentados
60 peticiones por minuto y 1.000 por hora y token, con respuestas 429 + Retry-After claras. Los límites de REST son una bolsa separada del consumo del MCP: uno nunca deja al otro sin cuota.
Empieza en 3 pasos
De cero a tu primera llamada a Search Console en un par de minutos.
Genera una clave
Conecta Search Console en SEOcrawl AI, abre Tokens de API y genera un token Bearer. Cópialo una sola vez: empieza por sca_live_.
Resuelve una propiedad
Llama a GET /v1/properties con Authorization: Bearer sca_live_… para obtener el id (un UUID) de la propiedad de Search Console que quieras leer.
Consulta tus datos de GSC
Llama a /v1/properties/{id}/gsc/summary?range=last_28_days para los totales, o a /gsc/top-keywords, /gsc/top-pages y los endpoints /detail — y envía el JSON directo a tu producto, tu dashboard o tu warehouse.
Tres formas de llegar a tus datos de Search Console
Las mismas cifras de GSC, distintas superficies: elige la que encaje con tu forma de construir.
API REST
Para productos, dashboards y pipelines de datos. Auth Bearer, JSON tipado, límites de uso. Estás en esta página: la API SEO completa añade endpoints de posiciones y visibilidad en IA con la misma clave.
Servidor MCP
Para agentes de IA: Claude, ChatGPT y cualquier cliente MCP preguntan a tus datos de Search Console en lenguaje natural.
Descubre el MCPTerminal y CLI
Para scripts y CI/CD: maneja tus datos de GSC desde cualquier agente de terminal compatible con MCP.
Ver la CLIQuién construye sobre la API de Search Console
Equipos que quieren datos reales de rendimiento de GSC dentro de sus propios sistemas.
Agencias
Lleva los datos de Search Console de cada cliente a un portal propio, a Looker Studio o a tu capa de reporting — una clave, todas las propiedades, sin exportaciones manuales de GSC.
SaaS y partners
Integra métricas de Search Console en vivo dentro de la interfaz de tu propio producto. Ofrece a tus usuarios clics, impresiones y posiciones sin cablear tú la API de Google.
Equipos de datos
Aterriza clics, impresiones, CTR y posición de GSC en tu warehouse de forma programada. Crúzalos con ingresos y construye los modelos que tus dashboards necesitan.
Desarrolladores
Automatiza la monitorización de consultas y páginas, avisa ante caídas de posiciones y conecta los datos de Search Console con las apps y flujos que ya tienes en producción.
Preguntas frecuentes
¿Es esta la API oficial de Search Console de Google?
No. Es la API REST propia de SEOcrawl AI, autenticada con Bearer, sobre los datos de Search Console que ya has conectado a tu cuenta. Conectas GSC una vez dentro de SEOcrawl AI y a partir de ahí lees clics, impresiones, CTR y posición con una única clave sca_live_ — sin crear un proyecto en Google Cloud, una pantalla de consentimiento OAuth ni un refresco de tokens. Las cifras son tus cifras reales de Search Console; la API y la autenticación son nuestras.
¿Qué datos de Search Console puedo obtener hoy?
Totales para un rango de fechas (clics, impresiones, CTR, posición media), comparativas entre periodos, tu top de consultas y de páginas con métricas, y el detalle diario completo de una keyword o de una página — además de la lista de tus propiedades conectadas. La cobertura de indexación y la inspección de URL en vivo ya están disponibles por MCP; sus endpoints REST llegan a continuación. Y si prefieres leer la cuenta en lugar de consultarla, la auditoría de Google Search Console cubre los mismos datos en un solo prompt.
¿Cómo me autentico?
Con un token Bearer. Genera una clave sca_live_ desde tu panel y envíala como Authorization: Bearer <clave> en cada petición. Para tu propia cuenta no hay baile de OAuth: sólo la cabecera.
¿Qué rangos de fechas admite?
Todos los endpoints de GSC aceptan o un range (last_7_days, last_28_days, last_3_months o last_year) o un par from/to explícito. El endpoint gsc/compare devuelve esa misma ventana comparada con el periodo anterior, así que obtienes las variaciones sin una segunda llamada.
¿Cuáles son los límites de uso?
60 peticiones por minuto y 1.000 por hora y token. Si los superas recibes un 429 con cabecera Retry-After. Los límites de REST se contabilizan aparte del consumo del MCP, así que nunca compiten por la misma bolsa.
¿Es la misma clave y los mismos datos que el MCP?
Sí. El mismo token sca_live_ autentica la API REST y el servidor MCP, y ambos leen de una única capa de datos canónica — así que las cifras de Search Console que obtienes por REST son idénticas a las que ven tus agentes de IA por MCP. Una credencial, dos superficies.
¿Listo para construir sobre tus datos de Search Console?
Conecta GSC una vez, genera una clave Bearer desde tu panel y haz tu primera llamada REST a Search Console en minutos — o descubre el MCP para agentes de IA.
