Límites de uso
La API aplica límites de peticiones para mantener el servicio estable. El límite depende de cómo te autenticas y del rol de tu cuenta (Default, Pro, VIP o Partner).
Ventajas por rol (resumen)
Sección titulada «Ventajas por rol (resumen)»| Rol | API Key | Endpoints pesados | Caché de comandos |
|---|---|---|---|
| Default | 30 req/min | 5 req/min | 60 s |
| Pro | 60 req/min | 12 req/min | 80 s |
| VIP | 90 req/min | 20 req/min | 120 s |
| Partner | 120 req/min | 40 req/min | 240 s |
- API Key: cuota general de bots (
/followage,/shoutout, minijuegos, etc.). - Pesados: solo
get-clipsychatterscuando van con API Key. - Caché de comandos: cuánto tiempo se reutiliza la respuesta en el chat. En followage se guarda la fecha del follow y el tiempo se recalcula en cada acierto de caché (el dato no se congela).
Además, un rol más alto obtiene datos más frescos en el panel (clips, chatters, analytics, “en vivo”, etc.).
Límites por rol (API Key / bots)
Sección titulada «Límites por rol (API Key / bots)»Cuando llamas a endpoints de bot con apiKey o X-Api-Key:
| Rol | Límite |
|---|---|
| Default | 30 req/min |
| Pro | 60 req/min |
| VIP | 90 req/min |
| Partner | 120 req/min |
Sesión del panel
Sección titulada «Sesión del panel»Las peticiones del panel (cookie lp_sess) usan:
max(500, rateLimit_del_rol × 10) req/min
| Rol | Efectivo (sin override) |
|---|---|
| Default | 500 req/min |
| Pro | 600 req/min |
| VIP | 900 req/min |
| Partner | 1200 req/min |
Incluye analytics, overlays, pruebas desde el panel y rutas /api/dashboard/* con sesión.
Endpoints pesados
Sección titulada «Endpoints pesados»Solo cuando la petición va con API Key (no con sesión del panel). La cuota escala con tu rol:
| Rol | Pesados |
|---|---|
| Default | 5 req/min |
| Pro | 12 req/min |
| VIP | 20 req/min |
| Partner | 40 req/min |
| Endpoint | Descripción |
|---|---|
GET /api/dashboard/get-clips |
Lista clips vía API de Twitch |
GET /api/dashboard/chatters |
Lista viewers del chat en vivo |
Desde el panel con sesión OAuth cuentan contra el límite de sesión, no contra el límite pesado.
Los comandos de bot (/followage, /shoutout, /create-clip, minijuegos, etc.) usan el límite general de tu rol.
Cabeceras de respuesta
Sección titulada «Cabeceras de respuesta»Las respuestas con rate limiting incluyen:
| Cabecera | Significado |
|---|---|
X-RateLimit-Limit |
Máximo de peticiones en la ventana actual |
X-RateLimit-Remaining |
Peticiones restantes en la ventana |
La ventana es un bucket rodante de 1 minuto (login OAuth usa ventana de 5 minutos en rutas /auth/*).
Caché por rol
Sección titulada «Caché por rol»Mayor rol implica más retención en comandos de chat (menos llamadas repetidas a Twitch) y datos más frescos en el panel / tools.
Comandos de chat (COMMAND)
Sección titulada «Comandos de chat (COMMAND)»| Rol | TTL |
|---|---|
| Default | 60 s |
| Pro | 80 s |
| VIP | 120 s |
| Partner | 240 s |
Panel y tools (más rol = más fresco)
Sección titulada «Panel y tools (más rol = más fresco)»| Recurso | Default | Pro | VIP | Partner |
|---|---|---|---|---|
| Chatters / stalker / ruleta | 45 s | 30 s | 20 s | 10 s |
| Clips (listado) | 60 s | 45 s | 30 s | 15 s |
| Mods / VIPs / subs (eligibility) | 90 s | 60 s | 40 s | 20 s |
| Analytics dashboard | 60 s | 45 s | 30 s | 15 s |
| Perfil dashboard | 300 s | 225 s | 150 s | 75 s |
| Feed de actividad | 20 s | 15 s | 10 s | 5 s |
| Estado en vivo | 45 s | 30 s | 15 s | 8 s |
En Configuración → General verás chips de req/min, heavy/min y caché de comandos para tu rol.
Otros límites públicos
Sección titulada «Otros límites públicos»| Contexto | Límite |
|---|---|
| IP anónima en rutas protegidas | 100 req/min |
Páginas HTML públicas (/, /docs) |
300 req/min por IP |
| Intentos fallidos de auth / escaneo | 60 req/min por IP |
Login OAuth (/auth/*) |
15 intentos / 5 min por IP |