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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Un 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.
- Envíe {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} por POST a /v1/twitch/clip.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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