Ко всем API
Публичные данные Twitch

Twitch Public Data API

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

Доступные API Twitch

Используйте Twitch Profile API для нормализованных идентификационных данных аккаунта, Twitch User Videos API для одной страницы публичных видео с поддерживаемыми фильтрами по типу и порядку или Twitch Clip Downloader API для одного публичного клипа по его ссылке.

Какие данные Twitch можно получить?

Каталог Twitch возвращает по имени пользователя одну нормализованную запись публичного аккаунта или одну страницу нормализованных публичных видео, а по ссылке на клип — один публичный клип; если источник не показывает значение, поле может быть null.

Идентификация профиля

Получайте доступные ID аккаунта, публичный URL, имя пользователя, отображаемое имя и описание профиля.

Оформление профиля

Сохраняйте доступные поля аватара, обложки и привязанного сайта.

Признаки аккаунта

Читайте признаки верификации и приватности, которые могут быть null, не додумывая отсутствующие значения.

Видимые счетчики аккаунта

Храните доступное число подписчиков, подписок и публикаций рядом с collected_at для сравнения на определенный момент.

Публичные видео пользователя

Собирайте с одной исходной страницы идентификационные данные видео, контекст автора, медиа, длительность, время публикации и видимую вовлеченность.

Публичные клипы

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

SocQ vs Twitch API

SocQ предоставляет получение публичных профилей, видео пользователей и клипов в нормализованных процессах задач; нативные API и аутентификация Twitch подходят для авторизованных интеграций приложений и операций с каналами.

ВозможностьSocQTwitch API
Основное назначениеПолучение публичного профиля, одной страницы видео пользователя или одного клипаСоздание нативных интеграций с ресурсами Twitch
АутентификацияAPI-ключ SocQПриложение Twitch и соответствующая авторизация пользователя или приложения
Входные данныеОдно имя пользователя, для клипов — одна ссылка на клипНативные параметры запроса и идентификаторы ресурсов Twitch
Управление каналомНе поддерживаетсяИспользуйте авторизованные API Twitch с нужными разрешениями
Формат ответаНормализованные записи SocQ AccountItem или ReelVideoItemНативные объекты ответа Twitch

Как работает API Twitch

Все API Twitch используют общий для SocQ процесс асинхронных задач и сохраненных результатов.

  1. 1. Выберите эндпоинт

    Отправьте методом POST одно корректное публичное имя пользователя на /v1/twitch/profile или /v1/twitch/user-videos либо одну ссылку на клип на /v1/twitch/clip и сохраните task_id.

  2. 2. Отслеживайте задачу

    Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.

  3. 3. Читайте сохраненные записи

    Берите записи профиля или видео из data.results.items и сохраняйте контекст времени сбора.

Получение публичного профиля Twitch

Пройдите аутентификацию с API-ключом SocQ и отправьте ровно одно поддерживаемое имя пользователя. Успешная задача стоит фиксированно 0,19 кредита.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Типичные сценарии использования API Twitch

Обогащение данных об авторах

Добавляйте к известным записям авторов доступные идентификационные данные Twitch, описание профиля, изображения, сайт, признаки аккаунта и публичные счетчики.

Сопоставление имен пользователей

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

Сравнение аккаунтов

Сравнивайте профили, собранные по отдельности, по одним и тем же полям идентификации и метрик, которые могут быть null.

Мониторинг снимков

Сохраняйте collected_at вместе со значениями публичного профиля, чтобы последующие запуски оставались различимыми снимками.

Обогащение перечня видео

Добавляйте к известным каналам идентификационные данные публичных видео, медиа, контекст автора, длительность, временные метки и видимую вовлеченность.

Архив лучших моментов

Сохраняйте MP4 клипа вместе с названием, стримером и временем создания, чтобы собрать по каналу библиотеку ярких моментов с поиском.

Ограничения и политика публичных данных

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

  • Profile и User Videos принимают только одно имя пользователя; URL канала, список имен пользователей и results_limit не принимаются.
  • Twitch Clip Downloader принимает одну ссылку на клип в формате twitch.tv/<channel>/clip/<slug> или clips.twitch.tv/<slug>; возвращаемая MP4-ссылка подписана и перестает работать примерно через сутки.
  • Имя пользователя может начинаться с одного символа @, а в остальном должно содержать от 1 до 64 символов: латинские буквы и цифры ASCII, точки, подчеркивания или дефисы.
  • Запрос профиля возвращает не более одного исходного объекта профиля; User Videos собирает одну исходную страницу и не принимает курсор или results_limit от вызывающей стороны.
  • Идентификационные данные профиля, изображения, сайт, признаки, местоположение и отдельные метрики могут быть null, если публичные исходные данные недоступны.
  • Эндпоинт не входит в аккаунт, не публикует, не модерирует, не управляет каналом, не получает приватную аналитику и не выполняет действий с аккаунтом через OAuth.

Частые вопросы об API Twitch

Что такое API Twitch?

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

Какие API Twitch сейчас доступны?

Сейчас доступны Twitch Profile API, Twitch User Videos API и Twitch Clip Downloader API.

Можно ли отправить URL Twitch?

Twitch Clip Downloader API принимает одну ссылку на клип в поле url. Twitch Profile и User Videos требуют username и отклоняют url, urls и другие необъявленные поля.

Управляет ли этот API каналом Twitch?

Нет. Все эндпоинты Twitch получают только публичные данные на чтение: они не авторизуют пользователя Twitch, не публикуют, не модерируют, не меняют настройки канала и не получают приватную аналитику.

Почему поля могут быть null?

Нормализованные записи аккаунтов и видео сохраняют необязательные публичные поля как null, если источник или провайдер не показывает значение на момент сбора.

Сколько стоят запросы к Twitch?

Каждая успешная задача Twitch Profile или User Videos стоит фиксированно 0,19 кредита SocQ. Каждый запрос к Twitch Clip Downloader стоит 0,5 кредита, а если клип не найден, кредиты полностью возвращаются.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

Rednote API

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

Kwai API

Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.

Truth Social API

Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.

Google Ad Library API

Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.

Google Maps API

Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.

Amazon API

Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.