Usar la API REST de Searvia
Lee rankings, visibilidad en IA, salud del sitio, reseñas y datos de mercado desde tus propios scripts y paneles, con las mismas claves y límites que MCP.
Unos 4 minutos
Qué necesitas
- Una clave de API de Ajustes › API y MCP
- Cualquier plan: Free incluye 100 llamadas de API y MCP al mes, Indie 1.000, Starter y superiores ilimitadas
- 1
Crea una clave
Cuenta › API y MCP
Crea una clave para el script o servidor que llamará a la API. Solo funciona en la cuenta en la que estás al crearla.
- 2
Envíala como token Bearer
Llama a https://searvia.com/api/v1 con el encabezado Authorization: Bearer seguido de tu clave. Empieza con GET /projects para ver los ids de tus proyectos.
- 3
Elige endpoints en la referencia
La página para desarrolladores lista todos los endpoints; el archivo OpenAPI en /api/v1/openapi.json incluye todos los campos y funciona con Postman, Insomnia y generadores de código.
- 4
Gestiona páginas, límites y errores
Las listas aceptan page y per_page. Vigila X-RateLimit-Remaining; ante un 429, espera el Retry-After. Los errores siempre llegan como error.status, error.code y error.message.
Qué obtienes
Tus datos fluyen a tus propias herramientas sin copiar desde el panel.
- Las llamadas que usan créditos se ejecutan sin vista previa y devuelven 402 cuando el saldo es insuficiente. Cada cambio hecho con una clave aparece en el registro de auditoría con el nombre de la clave.
- Para filas diarias planas (una palabra clave por día, una respuesta de IA, una auditoría) usa los endpoints de informes en /projects/{id}/reports.
Solución de problemas y preguntas
- ¿Es lo mismo que MCP?
- Sí. Cada endpoint ejecuta la misma herramienta que el servidor MCP, así que los resultados, los límites del plan y los créditos coinciden. MCP es para asistentes de IA; la API REST es para código.
- ¿Puede una conexión de solo lectura cambiar datos?
- No. Las apps conectadas con acceso de solo lectura reciben 403 en los endpoints que modifican o gastan.
También con MCP:list_projectsget_keyword_rankings