Twitch Clip Downloader
Клип Twitch — это короткий фрагмент, который зритель вырезает из прямой трансляции или записи эфира, и у него есть собственное название, slug, число просмотров, длительность, время создания, исходный стример, готовое видео и превью. По этим данным можно сохранять лучшие моменты вместе с видео, оценивать, как широко разошелся клип, и указывать правильный канал при репосте.
Возможности Twitch Clip Downloader API
- Оба формата ссылок на клипСсылка вида twitch.tv/канал/clip/slug и короткая clips.twitch.tv/slug ведут к одному и тому же клипу, поэтому ссылку из чата, X или Discord можно отправлять как есть.
- Воспроизводимый MP4 и превьюВ media лежат прямой MP4-адрес клипа и thumbnail_url — всё, что нужно, чтобы сохранить момент или показать его предпросмотр.
- Охват и время созданияmetrics.views_count, duration_seconds и published_at показывают общее число просмотров, длительность в секундах и момент создания клипа.
- Привязка к стримеруauthor содержит ID, логин, отображаемое имя, ссылку на канал, аватар и статус партнера стримера, так что каждый клип связан с каналом, в эфире которого он появился.
- Slug как постоянный ключshortcode возвращает slug клипа, а id — его числовой идентификатор; оба значения не меняются, даже когда меняются название или просмотры.
Параметры Twitch Clip Downloader API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Публичная ссылка на клип Twitch в формате https://www.twitch.tv/<channel>/clip/<slug> или https://clips.twitch.tv/<slug>. |
Как использовать Twitch Clip Downloader API
Отправьте ссылку на клип и прочитайте его как одну строку результата.
- Отправьте POST-запрос на /v1/twitch/clip, передав в поле url ссылку на клип, например https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте клип из results.items; has_more и results.next_cursor работают по обычным правилам пагинации и для этой единственной строки остаются пустыми.
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"}'Сценарии использования Twitch Clip Downloader API
- Архив лучших моментов эфира: Сохраняйте MP4 из media вместе с названием, стримером и published_at, чтобы собрать по каналу библиотеку ярких моментов с поиском.
- Отслеживание распространения клипа: Перечитывайте один и тот же клип несколько дней подряд и стройте график metrics.views_count по collected_at, чтобы видеть, набирает ли момент популярность.
- Корректное указание автора: Берите логин, отображаемое имя и ссылку на канал из author, чтобы правильно подписать клип перед тем, как добавить его в нарезку, рассылку или пост.
Практические советы по Twitch Clip Downloader API
- Скачивайте MP4 вскоре после завершения задачи: адрес в media подписан и перестает работать примерно через сутки.
- Храните клипы с ключом shortcode или id, а не по отправленной ссылке, потому что один и тот же клип распространяется в двух форматах ссылок.
- При каждом обновлении записывайте collected_at рядом с views_count, чтобы последующие замеры можно было сравнивать.
Связанные API
Помимо Twitch Clip Downloader API, используйте эти API, когда нужен другой тип публичных данных Twitch.
- Twitch Profile API — Преобразуйте одно публичное имя пользователя Twitch в нормализованную запись аккаунта с доступными данными аккаунта, описанием, изображениями, признаками аккаунта, видимыми метриками и контекстом сбора.
- Twitch User Videos API