API REST de OLAB Assist

Qué obtienes

• Endpoints para cuenta, sitios, detalle del sitio, hallazgos, respuestas de IA, historial y cambios.
• Los sitios se piden por id o dominio, p. ej. /sites/example.com.
• Paginación con next_cursor, 120 peticiones por minuto por clave.
• Contrato versionado: dentro de v1 los campos solo se añaden; nunca se quitan ni renombran.

Antes de empezar

• Una cuenta de OLAB Assist en el plan Agency, con la sesión del propietario.
• Una herramienta que envíe peticiones HTTP con cabeceras (curl, Postman, tu CRM, un script).

Configuración paso a paso

1. 1

   Crea una clave

   Integraciones → Claves de API: ponle el nombre de la herramienta (p. ej. “Sincronización HubSpot”) y pulsa Crear clave. Cópiala ahora; solo se muestra una vez.

2. 2

   Haz tu primera petición

   Envía la clave en la cabecera Authorization. El ejemplo lista tus sitios con su última puntuación.

3. 3

   Elige los datos

   Usa /sites/{site} para la vista completa, /findings para problemas, /answers para respuestas de IA y /history para la evolución. La referencia completa está en la documentación.

4. 4

   Prográmalo

   Ejecuta la importación a diario o tras cada webhook scan.completed, así no consultas más de lo necesario.

curl https://api.olabassist.com/api/v1/sites \
  -H "Authorization: Bearer olab_TU_CLAVE"

Consejos

• Una clave por integración: al revocarla solo afecta a esa herramienta.
• Ignora los campos que no conozcas. Se añaden nuevos con el tiempo y tu código sigue funcionando.
• Para Google Sheets basta un Apps Script con UrlFetchApp y un activador diario.

Solución de problemas

Preguntas