twitch/
clip

Obtiene un clip público de Twitch a partir de su URL y devuelve el título, las vistas, la duración, la fecha de creación, el perfil del streamer y un archivo MP4 directo con su miniatura.

Twitch Clip Downloader API

URL del clip como entrada
Enlace MP4 directo
Número de vistas
Perfil del streamer
0.5 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Twitch Clip Downloader

Un clip de Twitch es un fragmento corto que un espectador recorta de una transmisión en vivo o de un VOD, y tiene su propio título, slug, número de vistas, duración, fecha de creación, streamer de origen, video renderizado y miniatura. Con esos datos se pueden guardar los mejores momentos junto con su video, medir hasta dónde llega un clip y dar crédito al canal correcto cuando alguien lo comparte.

Funcionalidades de la Twitch Clip Downloader API

  • Los dos formatos de enlaceUn enlace twitch.tv/canal/clip/slug y uno corto clips.twitch.tv/slug llevan al mismo clip, así que lo copiado del chat, de X o de Discord se envía tal cual.
  • MP4 reproducible con miniaturamedia incluye la dirección MP4 directa del clip y su thumbnail_url, todo lo necesario para guardar o previsualizar el momento destacado.
  • Alcance y momento de creaciónmetrics.views_count, duration_seconds y published_at indican las vistas acumuladas, la duración en segundos y cuándo se creó el clip.
  • Streamer vinculadoauthor trae el ID, el usuario, el nombre visible, el enlace del canal, el avatar y el estado de partner del streamer, de modo que cada clip queda asociado al canal que lo emitió.
  • El slug como clave estableshortcode devuelve el slug del clip e id su identificador numérico, dos valores que se mantienen aunque cambien el título o las vistas.

Parámetros de la Twitch Clip Downloader API

ParámetrosObligatorioDescripción
urlObligatorioUn enlace público de clip de Twitch, con el formato https://www.twitch.tv/<channel>/clip/<slug> o https://clips.twitch.tv/<slug>.

Cómo usar la Twitch Clip Downloader API

Envíe el enlace de un clip y léalo como una única fila de resultado.

  1. Envíe {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} por POST a /v1/twitch/clip.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea el clip en results.items; has_more y results.next_cursor siguen las reglas de paginación habituales y quedan vacíos para esta fila única.
curl -X POST "https://api.socq.ai/v1/twitch/clip" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}'

Casos de uso de la Twitch Clip Downloader API

  • Archivar los mejores momentos: Guardar el MP4 de media con el título, el streamer y published_at para armar una biblioteca consultable con los momentos destacados de un canal.
  • Seguir la difusión de un clip: Leer el mismo clip durante varios días y graficar metrics.views_count frente a collected_at para ver si un momento está ganando tracción.
  • Dar crédito al compartir: Tomar el usuario, el nombre visible y el enlace del canal de author para atribuir bien un clip antes de incluirlo en una recopilación, un boletín o una publicación.

Consejos de expertos para la Twitch Clip Downloader API

  • Descargue el MP4 poco después de que termine la tarea, porque la dirección de media está firmada y deja de funcionar al cabo de un día aproximadamente.
  • Guarde los clips usando shortcode o id como clave en lugar de la URL enviada, ya que un mismo clip circula con dos formatos de enlace.
  • Registre collected_at junto a views_count en cada actualización para que las lecturas posteriores sean comparables.

Además de la Twitch Clip Downloader API, use estas APIs cuando necesite otro tipo de datos públicos de Twitch.

  • Twitch Profile API — Convierte un nombre de usuario público de Twitch en un registro de cuenta normalizado con identidad, biografía, imágenes, indicadores de cuenta, métricas visibles y contexto de recolección disponibles.
  • Twitch User Videos API

Explorar otras plataformas

Combine los datos de Twitch con datos públicos de otras plataformas sociales compatibles.

Twitch Clip Downloader API — FAQ

Twitch Clip Downloader API es una interfaz programática que obtiene un clip público de Twitch a partir de su URL de clip. Devuelve el título, las vistas, la duración, la fecha de creación, el slug, el perfil del streamer y un enlace MP4 directo con su miniatura.

Envíe un enlace de clip por solicitud, con el formato twitch.tv/canal/clip/slug o clips.twitch.tv/slug; el formato del enlace se comprueba antes de crear la tarea.

Sí. media contiene una dirección MP4 directa del clip; está firmada y caduca en torno a un día, así que conviene descargar el archivo en cuanto termine la tarea.

El resultado estándar reúne el clip, sus métricas y el streamer. El nombre del juego, la cuenta que recortó el clip y todas las calidades de video disponibles están en el archivo JSONL sin procesar que aparece entre los archivos de la tarea.

Cada solicitud lee un clip y cuesta 0.5 créditos; si el clip no se encuentra, la tarea falla y se reembolsa por completo.