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 подходят для авторизованных интеграций приложений и операций с каналами.
| Возможность | SocQ | Twitch API |
|---|---|---|
| Основное назначение | Получение публичного профиля, одной страницы видео пользователя или одного клипа | Создание нативных интеграций с ресурсами Twitch |
| Аутентификация | API-ключ SocQ | Приложение Twitch и соответствующая авторизация пользователя или приложения |
| Входные данные | Одно имя пользователя, для клипов — одна ссылка на клип | Нативные параметры запроса и идентификаторы ресурсов Twitch |
| Управление каналом | Не поддерживается | Используйте авторизованные API Twitch с нужными разрешениями |
| Формат ответа | Нормализованные записи SocQ AccountItem или ReelVideoItem | Нативные объекты ответа Twitch |
Как работает API Twitch
Все API Twitch используют общий для SocQ процесс асинхронных задач и сохраненных результатов.
1. Выберите эндпоинт
Отправьте методом POST одно корректное публичное имя пользователя на /v1/twitch/profile или /v1/twitch/user-videos либо одну ссылку на клип на /v1/twitch/clip и сохраните task_id.
2. Отслеживайте задачу
Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
3. Читайте сохраненные записи
Берите записи профиля или видео из data.results.items и сохраняйте контекст времени сбора.
Пройдите аутентификацию с 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 и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.


