La API de lectura de SemSerp te da tus datos en JSON o CSV para cruzarlos con lo que quieras: tu BI, tu CRM o un script. Funciona con todos los datos del rank tracker de SemSerp y de Search Console.
En resumen
- Autenticación con token en la cabecera Authorization: Bearer.
- Rutas para proyectos, keywords, subidas y bajadas, Search Console y visibilidad en IA.
- Añade ?format=csv para recibir CSV.
- Solo lectura, 5.000 llamadas al día. Disponible desde el plan Pro.
Antes de empezar
| Requisito | Detalle |
|---|---|
| Plan | Pro o superior |
| Token | Lo creas en Integraciones › API REST |
| Tiempo | 5 minutos para la primera llamada |
Paso 1: crea tu token
En Integraciones, en la tarjeta API REST, pulsa Crear token. El token solo se enseña una vez: guárdalo y no lo compartas. En la misma tarjeta verás la URL base de tu cuenta.

Paso 2: haz tu primera llamada
Envía el token en la cabecera Authorization:
curl -H "Authorization: Bearer sa_TU_TOKEN" \
"URL_BASE_DE_TU_TARJETA/v1/projects/ID_DEL_PROYECTO/keywords?device=mobile&max_position=10"
Rutas disponibles
| Ruta | Qué devuelve | Parámetros |
|---|---|---|
/v1/projects | Tus proyectos | — |
/v1/projects/{id}/keywords | Keywords con su posición | device, max_position |
/v1/projects/{id}/movers | Las que más suben y bajan | days (por defecto 7) |
/v1/projects/{id}/search-console | Datos de Search Console | kind: queries, pages, cannibal, ctr_drops o movers |
/v1/projects/{id}/ai-visibility | Visibilidad en IA | — |
Añade format=csv a cualquier ruta para recibir CSV en lugar de JSON.
Ideas de uso
- Volcar cada día tus posiciones en BigQuery o en tu base de datos.
- Cruzar keywords con ventas en tu BI.
- Generar informes propios con tu marca.
- Si prefieres recibir los cambios en vez de consultarlos, usa los webhooks.
Errores frecuentes y cómo resolverlos
| Problema | Causa probable | Solución |
|---|---|---|
| 401 No autorizado | Falta el token o es incorrecto | Revisa la cabecera Authorization: Bearer sa_… |
| 404 Ruta no encontrada | Ruta mal escrita | Empieza por /v1/projects y copia el id del proyecto |
| 429 o límite alcanzado | Has pasado de 5.000 llamadas al día | Guarda los resultados en caché y espacia las llamadas |
| Se filtró mi token | Alguien más puede leer tus datos | Genera uno nuevo en la tarjeta: el anterior deja de funcionar |
Buenas prácticas
- Guarda el token en variables de entorno, nunca en el código del repositorio.
- Pide solo los datos que necesitas con max_position y days.
- Programa las consultas después del chequeo diario para tener datos frescos.
Preguntas frecuentes
¿Puedo escribir o cambiar datos por API?
No. La API de SemSerp es solo de lectura.
¿Qué hago si se filtra mi token?
Genera uno nuevo desde la tarjeta de Integraciones: el anterior deja de funcionar al momento.
¿Hay límite de llamadas?
Sí, 5.000 llamadas al día por cuenta.
¿Desde qué plan está?
Desde el plan Pro.
¿La API devuelve datos históricos?
Devuelve la posición actual y la de hace 7 días, y las subidas y bajadas del periodo que indiques con days. Para guardar un histórico completo, consulta la API cada día o usa los webhooks.
Te puede interesar
Pruébalo con tu web
Crea tu cuenta y conecta tus datos SEO con tus herramientas por API.
Empieza gratisVer planes