API de plataforma de EveryData

API de Twitch

Q: ¿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.

Q: ¿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 de origen contengan un valor.

Q: ¿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.

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.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 6
Por 1.000: 1,389 US$

Funciones disponibles

Compara las acciones de Twitch por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`search` Buscar canales en Twitch 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.	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
`profile` Consultar un canal de Twitch 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.	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
`clips` Listar clips de un canal 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.	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 · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform
`streams` Buscar streams por juego Busca emisiones por `game`, con `keyword` opcional, y devuelve canal, título, espectadores e inicio. Los espectadores son una instantánea y no una audiencia histórica.	game	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	stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform
`top_streams` Explorar 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_games` Explorar 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é 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.

¿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. Para streams, usa el nombre exacto del juego o categoría en el parámetro game, 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 profile o clips. Puede incluir @. No procesa URL completas de twitch.tv.
Twitch: login, nombre visible y tipo de broadcasterLa 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 2026-09-04
include_clipsOpcional: Indica si profile debe incluir información de clips destacados. Es un valor booleano, true por defecto. El periodo de tiempo es diferente al de la acción clips.
include_videosOpcional: Indica si profile debe incluir información de vídeos recientes. Es un valor booleano, true por defecto. Si se establece en false, 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 profile o clips. Puede incluir @. No procesa URL completas de twitch.tv.
periodOpcional: Periodo de tiempo para clips: LAST_DAY (último día), LAST_WEEK (última semana, por defecto), LAST_MONTH (último mes) o ALL_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 reproduccionesLa 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 2026-09-04

¿Qué significan los parámetros de Twitch `streams`?

Busca emisiones por game, con keyword opcional, 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 espectadoresLa 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 2026-09-04
keywordOpcional: Palabra clave para buscar canales en search. Para streams, usa el nombre exacto del juego o categoría en el parámetro game, no una palabra clave del título de la transmisión.

¿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.

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.

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 devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

twitch_search.sh

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 de origen contengan 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.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →