SemSerpsemserp

API de lectura de SemSerp: guía para desarrolladores

API de lectura de SemSerp: guía para desarrolladores

Por el equipo de SemSerp · Actualizado en noviembre de 2026 · 6 min de lectura

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

RequisitoDetalle
PlanPro o superior
TokenLo creas en Integraciones › API REST
Tiempo5 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.

Tarjeta de la API REST de SemSerp con las rutas disponibles y el botón Crear token
La tarjeta de la API REST, con las rutas disponibles y el botón «Crear token».

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

RutaQué devuelveParámetros
/v1/projectsTus proyectos—
/v1/projects/{id}/keywordsKeywords con su posicióndevice, max_position
/v1/projects/{id}/moversLas que más suben y bajandays (por defecto 7)
/v1/projects/{id}/search-consoleDatos de Search Consolekind: queries, pages, cannibal, ctr_drops o movers
/v1/projects/{id}/ai-visibilityVisibilidad 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

ProblemaCausa probableSolución
401 No autorizadoFalta el token o es incorrectoRevisa la cabecera Authorization: Bearer sa_…
404 Ruta no encontradaRuta mal escritaEmpieza por /v1/projects y copia el id del proyecto
429 o límite alcanzadoHas pasado de 5.000 llamadas al díaGuarda los resultados en caché y espacia las llamadas
Se filtró mi tokenAlguien más puede leer tus datosGenera 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.

Pruébalo con tu web

Crea tu cuenta y conecta tus datos SEO con tus herramientas por API.

Empieza gratisVer planes