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 публичных каналов и выберите глубину сбора для каждого. Запрос создает асинхронную задачу, поэтому завершение и получение результатов — отдельные шаги.
- Подготовьте один или несколько URL публичных каналов YouTube с поддерживаемым путем: handle, ID канала, пользовательское имя или имя пользователя.
- Отправьте urls и results_limit методом POST на /v1/youtube/channel-live-videos и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте страницы результатов из /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, если источник сообщает эту классификацию.
Связанные API
Помимо 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 Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API