API de Twitch
Busca canales, consulta perfiles y clips, y explora streams o juegos públicos de Twitch. Usuario y juego se usan en acciones distintas con métricas propias.
Espectadores, seguidores y canales activos son instantáneas, no audiencia acumulada o ingresos. El estado Partner o Affiliate no verifica identidad ni disponibilidad en directo.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Twitch, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar canales en Twitchsearch | Busca canales de Twitch mediante keyword, devolviendo perfil, seguidores y señales de Partner o Affiliate. | $1.39 por 1.000 solicitudes | Normal |
Consultar un canal de Twitchprofile | Consulta un username y puede incluir clips o videos mediante interruptores explícitos. | $1.39 por 1.000 solicitudes | Normal |
Listar clips de un canalclips | Obtiene clips del username para el period seleccionado, con juego, duración, vistas y curador. | $1.39 por 1.000 solicitudes | Normal |
Buscar streams por juegostreams | Busca emisiones por game y devuelve canal, título, espectadores e inicio. | $1.39 por 1.000 solicitudes | Normal |
Explorar streams destacadostop_streams | Consulta streams destacados sin parámetros de negocio y conserva juego, canal y espectadores observados. | $1.39 por 1.000 solicitudes | Normal |
Explorar juegos destacadostop_games | Obtiene juegos destacados sin entrada adicional, con espectadores y número de canales visibles. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Twitch?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar canales en Twitch Busca canales de Twitch mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · platform |
profileConsultar un canal de Twitch Consulta un | username | include_clips, include_videos | Entrega síncrona | — | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · recent_videos · top_clips · platform |
clipsListar clips de un canal Obtiene clips del | username | period | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · title · url · view_count · duration_seconds · duration_sec · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform |
streamsBuscar streams por juego Busca emisiones por | game | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform |
top_streamsExplorar streams destacados Consulta streams destacados sin parámetros de negocio y conserva juego, canal y espectadores observados. La posición no es un ranking permanente ni una recomendación propia. | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | |
top_gamesExplorar juegos destacados Obtiene juegos destacados sin entrada adicional, con espectadores y número de canales visibles. No representa ventas, jugadores totales o popularidad fuera de Twitch. | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · name · viewer_count · broadcaster_count · box_art_url · url · platform |
¿Qué significan los parámetros de Twitch search?
Busca canales de Twitch mediante keyword, devolviendo perfil, seguidores y señales de Partner o Affiliate. No busca el chat ni certifica que el canal esté en directo.
keywordObligatorio- Palabra clave para buscar canales en
search. Parastreams, usa el nombre exacto del juego o categoría en el parámetrogame, no una palabra clave del título de la transmisión.
¿Qué significan los parámetros de Twitch profile?
Consulta un username y puede incluir clips o videos mediante interruptores explícitos. Devuelve ficha pública; no expone ingresos, suscriptores nominales o analítica privada.
usernameObligatorio- Nombre de usuario corto (login) del canal de Twitch para
profileoclips. Puede incluir@. No procesa URL completas detwitch.tv.Twitch: login, nombre visible y tipo de broadcaster — La API oficial de Twitch separa `login`, `display_name` y `broadcaster_type`. `username` debe ser el nombre corto del canal; un nombre visible o una categoría Partner/Affiliate no son credenciales ni identificadores equivalentes. · Consultada include_clipsOpcional- Indica si
profiledebe incluir información de clips destacados. Es un valor booleano,truepor defecto. El periodo de tiempo es diferente al de la acciónclips. include_videosOpcional- Indica si
profiledebe incluir información de vídeos recientes. Es un valor booleano,truepor defecto. Si se establece enfalse, no se obtendrá esta sección. No pases la cadena de texto"false".
¿Qué significan los parámetros de Twitch clips?
Obtiene clips del username para el period seleccionado, con juego, duración, vistas y curador. El rango no garantiza cubrir todos los clips ni atribuye autoría al curador.
usernameObligatorio- Nombre de usuario corto (login) del canal de Twitch para
profileoclips. Puede incluir@. No procesa URL completas detwitch.tv. periodOpcional- Periodo de tiempo para
clips:LAST_DAY(último día),LAST_WEEK(última semana, por defecto),LAST_MONTH(último mes) oALL_TIME(sin límite). El valor no distingue mayúsculas de minúsculas. Si el valor no es válido, se usaráLAST_WEEK.Twitch: creador del `Clip`, canal de origen y número de reproducciones — La documentación oficial de `Clip` separa al `broadcaster` del `creator`, y define `view_count` como el número de visualizaciones del vídeo corto y `duration` en segundos. Aquí solo se verifica la terminología; no se replican las fechas de inicio y fin, los cursores ni los parámetros de creación de cortos oficiales. · Consultada
¿Qué significan los parámetros de Twitch streams?
Busca emisiones por game y devuelve canal, título, espectadores e inicio. Los espectadores son una instantánea y no una audiencia histórica.
gameObligatorio- Nombre exacto de la categoría de Twitch para
streams, por ejemplo,Just Chatting. Obtiene los canales que están transmitiendo en vivo en esa categoría, no las grabaciones históricas de ese juego.Twitch: categoría del directo y número actual de espectadores — La documentación oficial de directos distingue entre la categoría, el canal y la transmisión actual, explicando `viewer_count` como el número de usuarios que están viendo el directo en ese momento. No representa las reproducciones de un `Clip`, el número de seguidores ni el total histórico de visualizaciones; el parámetro oficial `game_id` tampoco sustituye al nombre de la categoría requerido en esta página. · Consultada
¿Qué significan los parámetros de Twitch top_streams?
Consulta streams destacados sin parámetros de negocio y conserva juego, canal y espectadores observados. La posición no es un ranking permanente ni una recomendación propia.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.
¿Qué significan los parámetros de Twitch top_games?
Obtiene juegos destacados sin entrada adicional, con espectadores y número de canales visibles. No representa ventas, jugadores totales o popularidad fuera de Twitch.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.
Cómo usar la API de Twitch
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitch","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Twitch
¿Cómo llamo a la API de Twitch?
Envía POST /api/v1/social con platform igual a twitch, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Twitch?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye user_id, username, display_name y bio. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Twitch?
La API oficial de Twitch separa login, display_name y broadcaster_type. username debe ser el nombre corto del canal; un nombre visible o una categoría Partner/Affiliate no son credenciales ni identificadores equivalentes.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere username; clips requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Twitch responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.