API REST · v1 · Docs en vivo

API de SEO para tu propio stack

Tus datos de SEO y visibilidad en IA, sobre un endpoint REST limpio.

Trae datos de Google Search Console, ranking y AI Tracker directamente a tu producto, dashboard o data warehouse. Autentícate con una clave Bearer desde tu dashboard, llama a la REST `/v1` y recibe JSON tipado — la misma capa de datos canónica que impulsa el MCP de SEOcrawl AI. GA4, la exportación completa de auditoría de sitio y el OAuth multi-tenant para partners llegan a continuación.

Consigue tu clave de API Explora el MCP

Auth Bearer · 60 req/min · La misma capa de datos que el MCP · Sin scraping

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Autentícate una vez. Llama a la REST.

Genera un token Bearer desde tu dashboard y pásalo en la cabecera Authorization. La misma clave funciona tanto en la API REST como en el servidor MCP.

URL base

https://api.seocrawl.ai/v1

Cabecera Authorization

Authorization: Bearer sca_live_your_token_here

Consigue tu clave de API Read the API docs

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Endpoints

Una capa de datos, dos superficies

Cada endpoint REST lee de la misma capa canónica que las herramientas MCP — así tu dashboard y tus agentes de IA siempre ven cifras idénticas. Estos grupos están en vivo en v1; se añade más cobertura de forma continua.

Propiedades

Lista las propiedades de Search Console a las que tienes acceso. Usa el `id` de cada propiedad en el path de cada endpoint de datos.

GET/v1/propertiesEn vivo

Google Search Console

Clics, impresiones, CTR y posición media — por consulta, página, rango de fechas y período sobre período.

GET/v1/properties/{id}/gsc/summaryEn vivo
GET/v1/properties/{id}/gsc/compareEn vivo
GET/v1/properties/{id}/gsc/top-keywordsEn vivo
GET/v1/properties/{id}/gsc/top-pagesEn vivo
GET/v1/properties/{id}/gsc/keywords/detailEn vivo
GET/v1/properties/{id}/gsc/pages/detailEn vivo

AI Tracker

Lee los prompts que monitorizas en busca de menciones de marca en ChatGPT, Claude, Gemini y Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsEn vivo

Tareas

Lee y escribe tareas SEO — conecta tu tablero de tareas con tu propio stack de gestión de proyectos.

GET/v1/properties/{id}/tasksEn vivo
POST/v1/properties/{id}/tasksEn vivo
GET/v1/properties/{id}/tasks/{ticketId}En vivo
PATCH/v1/properties/{id}/tasks/{ticketId}En vivo
POST/v1/properties/{id}/tasks/{ticketId}/commentsEn vivo

GA4 e indexación

Tráfico, referrers de IA y estado de indexación. La conexión está lista; los endpoints REST están saliendo.

GET/v1/properties/{id}/ga4/summaryPronto
GET/v1/properties/{id}/indexation/summaryPronto

Auditoría de sitio

Salud del rastreo, on-page, técnico y listas de problemas — el dataset completo de auditoría, expuesto vía REST.

GET/v1/properties/{id}/audit/summaryPronto
GET/v1/properties/{id}/audit/issuesPronto

Por qué esta API

Hecha para productos, no para scrapers

Una API REST de verdad con auth Bearer, scopes y límites de peticiones — que comparte una única capa de datos canónica con el MCP para que las cifras nunca discrepen.

REST limpia, JSON tipado

Recursos predecibles, verbos estándar, respuestas JSON tipadas y errores conformes al RFC (401 sin autenticar, 403 scope_required, 429 con Retry-After). Sin scraping de HTML, sin exportaciones frágiles.

Una capa de datos canónica

Los endpoints REST y las herramientas MCP son hermanos sobre los mismos proveedores, con la paridad probada en CI. Tu dashboard y tus agentes de IA siempre ven clics, impresiones y posiciones idénticos.

Claves autoservicio

Genera y revoca tokens Bearer desde tu dashboard en segundos. La misma clave sca_live_ autentica tanto la API REST como el servidor MCP — una credencial, dos superficies.

Límites de peticiones documentados

60 peticiones por minuto y 1,000 por hora por token, con respuestas claras 429 + Retry-After. Los límites REST son una bolsa separada del uso del MCP — uno nunca deja sin recursos al otro.

Acceso con scopes

Scopes gruesos de lectura y escritura protegen cada endpoint, aplicados en el firewall con respuestas estándar de step-up. Concede a una clave solo lo que necesita.

Multi-tenant, próximamente

Un flujo de Google OAuth por tenant para que los partners puedan conectar cada propiedad de GSC de sus clientes bajo una sola cuenta — con aislamiento estricto de datos. En desarrollo activo; pídenos acceso anticipado.

Empieza en 3 pasos

De cero a tu primera llamada autenticada en un par de minutos.

Genera una clave

Abre API tokens en tu dashboard y genera un token Bearer. Cópialo una sola vez — empieza por `sca_live_`.

Envía la cabecera

Pasa `Authorization: Bearer sca_live_…` en cada petición a `https://api.seocrawl.ai/v1`. La misma clave también funciona con el servidor MCP.

Trae datos

Llama a `GET /v1/properties` para obtener un `id` de propiedad, luego consulta `/v1/properties/{id}/…` para el rendimiento de GSC, los prompts de AI Tracker o las tareas — y canaliza el JSON directamente a tu producto, dashboard o warehouse.

Tres maneras de llegar a tus datos

Las mismas cifras, distinta superficie — elige la que encaje con cómo construyes.

API REST

Para productos, dashboards y pipelines de datos. Auth Bearer, JSON tipado, límites de peticiones. Estás en esta página.

Servidor MCP

Para agentes de IA — Claude, ChatGPT y cualquier cliente MCP consultan tus datos en lenguaje natural.

Explora el MCP

Terminal y CLI

Para scripts y CI/CD — maneja tus datos desde cualquier agente de terminal compatible con MCP.

Ver el CLI

Compara todas las integraciones

Quién construye sobre la API

Equipos que quieren datos de SEO y visibilidad en IA dentro de sus propios sistemas.

SaaS y partners

Integra métricas SEO en vivo en la UI de tu propio producto. Ofrece a tus usuarios datos de Search Console y visibilidad en IA sin construir tú mismo los pipelines.

Agencias

Canaliza los datos de cada cliente hacia un portal a medida, Looker Studio o tu capa de reporting — una clave, todas las propiedades, sin exportaciones manuales.

Equipos de datos

Aterriza datos de GSC, ranking y AI Tracker en tu warehouse de forma programada. Únelos con los ingresos y construye los modelos que tus dashboards necesitan.

Desarrolladores

Automatiza comprobaciones y alertas, sincroniza tareas con tu herramienta de PM y conecta la monitorización de visibilidad en IA con las apps que ya lanzas.

Preguntas frecuentes

¿Existe de verdad una API pública de SEO?

Sí — una API REST `/v1` autenticada con Bearer está en vivo, cubriendo el rendimiento de Search Console, las propiedades, los prompts de AI Tracker y las tareas, con la referencia pública completa publicada en api.seocrawl.ai/docs. Más cobertura (GA4, exportación completa de auditoría de sitio) y el OAuth multi-tenant para partners llegan a continuación. ¿Necesitas algo que aún no está en vivo? Pídenos acceso anticipado.

¿Cómo me autentico?

Con un token Bearer. Genera una clave `sca_live_` desde tu dashboard y envíala como `Authorization: Bearer <key>` en cada petición. No hay ningún baile de OAuth para tu propia cuenta — solo la cabecera.

¿Es la misma clave que la del MCP?

Sí. El mismo token autentica tanto la API REST como el servidor MCP, porque ambos leen de una única capa de datos canónica. Una credencial, dos superficies — y cifras idénticas entre ellas.

¿Cuáles son los límites de peticiones?

60 peticiones por minuto y 1,000 por hora por token. Si los superas, recibes un `429` con una cabecera `Retry-After`. Los límites REST se contabilizan por separado del uso del MCP, así que los dos nunca compiten por el mismo presupuesto.

¿Puedo conectar las propiedades de Search Console de mis clientes?

Ese flujo multi-tenant para partners — un Google OAuth por tenant para que puedas conectar cada propiedad de GSC de tus clientes bajo tu propia cuenta, con aislamiento estricto de datos — está en desarrollo activo. Si estás construyendo una integración de partner, ponte en contacto para acceso anticipado.

¿Qué datos puedo traer hoy?

Resumen de Search Console y comparativas de períodos, keywords y páginas top, detalle de una sola keyword/página, tu lista de propiedades, los prompts de AI Tracker y lectura/escritura completas sobre tareas. Refleja lo que expone el MCP, sobre REST.

¿Listo para construir sobre tus datos de SEO?

Genera una clave Bearer desde tu dashboard y haz tu primera llamada REST en minutos — o habla con nosotros sobre acceso para partners y multi-tenant.

Consigue tu clave de API Reserva una demo