Scrolleai / Documentación

De un video a datos que tu IA puede usar.

Conecta Scrolleai mediante MCP o API. Envía la URL de un video público de TikTok o Instagram y recibe estadísticas, contexto y transcripción cuando estén disponibles.

Crear API key →Configurar MCP ↓

01 / Primeros pasos

Crea tu API key

Entra a Tu cuenta, elige un plan y crea una clave cuando se confirme el pago. La misma clave sirve para la API y para MCP.

01Activa un plan

El acceso comienza cuando se confirma el pago.

02Crea una clave

Asígnale un nombre para reconocer dónde la usas.

03Guárdala

La clave completa se muestra una sola vez. Puedes revocarla desde tu cuenta.

02 / Primeros pasos

Autenticación

Envía tu clave en la cabecera Authorization con el esquema Bearer en cada solicitud. Configura tu cliente MCP con la misma clave.

Authorization: Bearer TU_API_KEY

Mantén la clave en tu servidor o en la configuración local de tu agente. Evita incluirla en código que corre en el navegador o en repositorios compartidos.

03 / MCP

Conecta Scrolleai a tu agente

Agrega el servidor remoto https://scrolleai.com/api/mcp a tu cliente. Elige la pestaña de tu agente para ver una configuración lista para adaptar.

# En tu entorno local:
export SCROLLEAI_API_KEY="TU_API_KEY"

# En ~/.codex/config.toml:
[mcp_servers.scrolleai]
url = "https://scrolleai.com/api/mcp"
bearer_token_env_var = "SCROLLEAI_API_KEY"

Reinicia Codex después de guardar la configuración y comprueba el servidor con codex mcp list.

Consulta también las guías de configuración de Codex ↗, Claude Code ↗ y Cursor ↗.

Un prompt para tu agente

Configura el MCP remoto de Scrolleai para este agente. La URL es https://scrolleai.com/api/mcp. Usa mi API key desde la variable de entorno SCROLLEAI_API_KEY y envíala como Authorization: Bearer. No imprimas la clave ni la guardes en archivos del proyecto. Verifica que esté disponible la herramienta get_video y muéstrame cómo pedirle que analice un video público de TikTok o Instagram.

04 / MCP

Prueba la herramienta

Una vez conectado, tu agente podrá usar get_video. La herramienta recibe url y devuelve en JSON los mismos datos que el endpoint de API.

TOOLget_videourl: string

Prueba preguntándole: “Analiza este video público de TikTok y dime sus vistas, comentarios y puntos principales de la transcripción: [URL]”. Una consulta exitosa consume un video de tu cupo.

05 / API REST

Consulta un video

POST/api/v1/videos/resolve

Envía un cuerpo JSON con url. Se aceptan enlaces HTTPS públicos de videos de TikTok y de reels o publicaciones de video de Instagram.

curl -X POST https://scrolleai.com/api/v1/videos/resolve \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mi-video-001" \
  -d '{"url":"https://www.tiktok.com/@creador/video/123456789"}'

Reemplaza TU_API_KEY y la URL del video. Usa una Idempotency-Key distinta para cada consulta nueva.

URL completa: https://scrolleai.com/api/v1/videos/resolve. Cada solicitud exitosa consume un video, tanto por API como por MCP.

06 / API REST

Consulta tu uso

GET/api/v1/usage

Consulta el cupo de tu plan, los videos usados y los videos extra disponibles con la misma cabecera de autorización.

curl https://scrolleai.com/api/v1/usage \
  -H "Authorization: Bearer TU_API_KEY"

Ver ejemplo de respuesta

{
  "active": true,
  "plan": "starter",
  "monthlyLimit": 300,
  "monthlyUsed": 17,
  "monthlyRemaining": 283,
  "extraRemaining": 0,
  "periodEnd": "2026-10-22T00:00:00.000Z"
}

07 / API REST

Entiende la respuesta

Scrolleai normaliza los datos de ambas plataformas. Un campo numérico o la transcripción puede ser null si la plataforma no lo publica.

{
  "platform": "tiktok",
  "url": "https://www.tiktok.com/@creador/video/123456789",
  "videoId": "123456789",
  "creator": "creador",
  "caption": "Texto del video",
  "views": 1586514,
  "likes": 36321,
  "comments": 2602,
  "shares": 95399,
  "durationSeconds": 34,
  "transcript": "WEBVTT...",
  "transcriptStatus": "native",
  "retrievedAt": "2026-09-22T12:00:00.000Z"
}

views, likes, comments, sharesConteos disponibles del video. comments es un número, no el texto de comentarios.

transcriptTexto o transcripción disponible para el video.

transcriptStatusnative, generated, unavailable o unsupported.

08 / Referencia

Cupo y reintentos

Una consulta exitosa consume una unidad de tu plan. Si repites la consulta, consume otra unidad. Para evitar duplicados al reintentar por fallos de red, envía el mismo encabezado Idempotency-Key con el mismo video; una respuesta ya completada se reutiliza sin volver a descontar cupo.

El cupo mensual se renueva con tu suscripción. Si lo agotas, puedes comprar 100 videos extra por US$5 desde Tu cuenta. No vencen por fecha y requieren una suscripción activa para usarlos. Las solicitudes fallidas no consumen cupo.

Se admiten hasta 60 consultas de videos por minuto por cuenta. Cuando alcanzas el límite o agotas tu cupo, la API devuelve 429.

09 / Referencia

Errores habituales

400La URL o el encabezado de idempotencia no es válido.

401Falta la clave o fue revocada.

402No hay una suscripción de pago activa.

404 / 422El video no existe, no es público o la publicación no contiene video.

409La clave de idempotencia ya se usó para otro video o la solicitud sigue en proceso.

429Se agotó el cupo o el límite de solicitudes por minuto.

502 / 504El proveedor no respondió correctamente o la consulta expiró. Puedes reintentarla.

10 / Referencia

Transcripciones y disponibilidad

Instagram puede generar transcripciones para videos de menos de dos minutos con voz. TikTok entrega las transcripciones nativas disponibles; no se usa generación adicional con IA. Si no hay una transcripción, transcript es null y transcriptStatus explica por qué.

Scrolleai consulta únicamente contenido público. La disponibilidad de cada métrica depende de los datos que publique la plataforma.

¿Listo para conectar tu agente?Crear API key →