Introducción
LosPerris Twitch API es una API REST gratuita para streamers de Twitch. Expone comandos de chat, herramientas para el directo y minijuegos que tu comunidad puede usar desde Nightbot, StreamElements, Fossabot, Wizebot, Streamlabs o tu propio bot.
El panel en ttv.losperris.dev genera las URLs con tu API Key, permite probar cada endpoint y ofrece overlays para OBS en herramientas como Tendencias, Ruleta o Preguntas.
Qué incluye
Sección titulada «Qué incluye»| Categoría | Qué hace | Ejemplos |
|---|---|---|
| Comandos | Respuestas de texto para el chat de Twitch | Followage, Clips, Shoutout |
| Herramientas | Utilidades para el stream y overlays | Tendencias, Stalker, Ruleta, Preguntas |
| Minijuegos | Interacción con viewers desde el chat | Bola 8, Ruleta Rusa, Duelo |
| Extras | Endpoints auxiliares y referencia de errores | Listar clips, códigos de error |
La mayoría de endpoints devuelven texto listo para el chat. Algunos (clips, analytics, overlays) devuelven JSON o abren una URL en el navegador.
URL base
Sección titulada «URL base»Todos los ejemplos de esta documentación usan:
https://ttv.losperris.dev/api/<endpoint>?apiKey=TU_API_KEY&...También puedes enviar la clave en la cabecera X-Api-Key. Para bots antiguos sigue funcionando el prefijo legacy /twitch/ (ej. https://ttv.losperris.dev/twitch/followage?...).
Autenticación en dos niveles
Sección titulada «Autenticación en dos niveles»| Uso | Cómo te autenticas | Para qué sirve |
|---|---|---|
| Bots de chat | apiKey en la URL o X-Api-Key |
Nightbot, StreamElements, scripts propios |
| Panel web | Cookie de sesión HttpOnly (lp_sess) |
Dashboard, overlays, analytics |
Los bots no necesitan iniciar sesión en el panel: solo tu API Key. La clave se crea en tu primer login con Twitch y puedes regenerarla desde Configuración → Seguridad.
Límites y estabilidad
Sección titulada «Límites y estabilidad»La API aplica rate limits según el rol de tu cuenta (30–120 req/min con API Key), un límite de sesión del panel que escala con el rol (desde 500 req/min) y cuotas pesadas para clips/chatters (5–40 req/min según rol).
Consulta Límites de uso para el detalle por rol y endpoint.