twitch/
clip

Получает публичный клип Twitch по его ссылке и возвращает название, просмотры, длительность, время создания, профиль стримера, а также прямой MP4-файл с превью.

Twitch Clip Downloader API

Ссылка на клип на входе
Прямая MP4-ссылка
Число просмотров
Профиль стримера
0,5 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

Отправьте ссылку на клип и прочитайте его как одну строку результата.

  1. Отправьте POST-запрос на /v1/twitch/clip, передав в поле url ссылку на клип, например https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте клип из 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, чтобы последующие замеры можно было сравнивать.

Помимо Twitch Clip Downloader API, используйте эти API, когда нужен другой тип публичных данных Twitch.

  • Twitch Profile API — Преобразуйте одно публичное имя пользователя Twitch в нормализованную запись аккаунта с доступными данными аккаунта, описанием, изображениями, признаками аккаунта, видимыми метриками и контекстом сбора.
  • Twitch User Videos API

Другие платформы

Объединяйте данные Twitch с публичными данными других поддерживаемых соцсетей.

Twitch Clip Downloader API — FAQ

Twitch Clip Downloader API — это программный интерфейс, который получает публичный клип Twitch по ссылке на этот клип. Он возвращает название, просмотры, длительность, время создания, slug, профиль стримера, а также прямую MP4-ссылку с превью.

В каждом запросе передается одна ссылка на клип: twitch.tv/канал/clip/slug или clips.twitch.tv/slug; формат ссылки проверяется еще до создания задачи.

Да. В media содержится прямой MP4-адрес клипа; он подписан и истекает примерно через сутки, поэтому файл лучше скачать сразу после завершения задачи.

Стандартный результат содержит сам клип, метрики и стримера. Название игры, аккаунт, который вырезал клип, и все доступные качества видео находятся в исходном файле JSONL из списка файлов задачи.

Каждый запрос читает один клип и стоит 0,5 кредита; если клип не найден, задача завершается ошибкой и полностью возвращается на баланс.