youtube/
channel-live-videos

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

YouTube Channel Live Videos API

Раздел трансляций канала
Публичные трансляции
Асинхронный сбор
0,5 кредита за результат
Готово
Готово

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

README

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

YouTube Channel Live Videos

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

Возможности YouTube Channel Live Videos API

  • Поддержка канонических URL каналовРаспознает публичные URL YouTube вида /@handle, /channel/{id}, /c/{name} и /user/{name}.
  • Поиск в разделе трансляций каналаСобирает записи о трансляциях, доступные в разделе трансляций каждого переданного канала.
  • Глубина сбора для каждого каналаЗапрашивайте от 20 до 2 000 записей для каждого входного канала, по умолчанию 100.
  • Нормализованные записи трансляцийВозвращает идентификаторы видео, название, описание, канал, превью, длительность, хештеги, время публикации и контекст источника, если они доступны.
  • Снимки видимой вовлеченностиФиксирует публичное число просмотров, лайков и комментариев вместе с collected_at для анализа на определенный момент.
  • Асинхронная выдача результатовОпрашивайте статус задачи, сохраняйте ID задачи и используйте курсорную пагинацию для надежного асинхронного получения результатов.

Параметры YouTube Channel Live Videos API

ПараметрыОбязательныйОписание
urlsОбязательныйURL публичных каналов YouTube, разделенные запятыми или переводами строки. Поддерживаются пути /@handle, /channel/{id}, /c/{name} и /user/{name}.
results_limitНеобязательныйМаксимальное число записей, запрашиваемых для каждого URL канала. Целое число от 20 до 2 000, по умолчанию 100.

Как использовать YouTube Channel Live Videos API

Отправьте канонические URL публичных каналов и выберите глубину сбора для каждого. Запрос создает асинхронную задачу, поэтому завершение и получение результатов — отдельные шаги.

  1. Подготовьте один или несколько URL публичных каналов YouTube с поддерживаемым путем: handle, ID канала, пользовательское имя или имя пользователя.
  2. Отправьте urls и results_limit методом POST на /v1/youtube/channel-live-videos и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте страницы результатов из /v1/tasks/{task_id}?limit=50 и передавайте next_cursor обратно как cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}

Сценарии использования YouTube Channel Live Videos API

  • Каталог трансляций: Составляйте структурированный список публичных трансляций, связанных с выбранными каналами.
  • Исследование программы прямых эфиров: Сравнивайте названия, время, длительность и закономерности публикаций у каналов с регулярными прямыми эфирами.
  • Мониторинг трансляций авторов: Отслеживайте, какие публичные записи о трансляциях видны в разделах каналов авторов, брендов, издателей или конкурентов.
  • Снимки результатов после трансляции: Сохраняйте видимые просмотры, лайки и комментарии вместе со временем сбора для последующего сравнения динамики.
  • Обогащение каталога публичных медиа: Добавляйте нормализованные метаданные трансляций и контекст исходного канала в системы поиска, отчетности или классификации.

Практические советы по YouTube Channel Live Videos API

  • results_limit применяется к каждому каналу. Пять URL с лимитом 100 запрашивают до 500 записей до дедупликации в пределах задачи.
  • Используйте канонические URL каналов с непустым handle, ID канала, пользовательским именем или именем пользователя; голый путь /channel не позволяет определить источник.
  • Считайте раздел трансляций канала границей отбора. Доступность текущих, запланированных и архивных трансляций может меняться между сборами.
  • Не определяйте надежное состояние «текущая/запланированная/архивная» по type или extra.content_type: в нормализованных данных нет отдельного поля статуса трансляции.
  • Ответ содержит метаданные и ссылки на превью, но не чат трансляции, URL воспроизводимого потока, субтитры или текст расшифровки.
  • Равнозначные входные данные о канале могут найти одно и то же видео. Сохраненные результаты задачи дедуплицируются по нормализованному ID видео, а при его отсутствии — по URL.
  • Лимит результатов задачи не связан с results_limit: запрашивайте от 1 до 500 сохраненных строк на страницу и передавайте непрозрачный next_cursor, пока has_more не станет false.
  • Публичные метаданные не открывают доступ к приватному просмотру или просмотру только для участников. Сохраняйте extra.is_members_only, если источник сообщает эту классификацию.

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

  • YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
  • YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
  • YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
  • YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
  • YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
  • YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.

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

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

YouTube Channel Live Videos API — FAQ

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

Используйте публичный URL youtube.com с путем /@handle, /channel/{id}, /c/{name} или /user/{name}. Сегмент с идентификатором не должен быть пустым.

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

Нет. extra.content_type может сохранять классификацию источника, если она есть, но не является надежной заменой отдельного статуса «текущая», «запланированная» или «архивная».

По умолчанию results_limit равен 100, принимает значения от 20 до 2 000 и применяется отдельно к каждому переданному URL канала. Фактически сохраненных строк может быть меньше из-за доступности канала и дедупликации видео в пределах задачи.

Нет. Эндпоинт возвращает публичные метаданные трансляций и ссылки на превью; он не возвращает сообщения чата, воспроизводимые файлы потока, субтитры или расшифровки.

Стоимость запроса предварительно оценивается как число URL каналов, умноженное на results_limit, а затем пересчитывается по 0,5 кредита за каждый сохраненный нормализованный результат. За пустой результат плата не взимается, потому что настроенная базовая плата равна нулю.