YouTube Channel Videos
Видео канала YouTube — это обычные загрузки конкретного канала с названиями, описаниями, превью, длительностью, сведениями о публикации и видимой вовлеченностью. Такие записи помогают вести каталог каналов, анализировать публикации, отслеживать контент и строить отчеты за прошлые периоды.
Возможности YouTube Channel Videos API
- Сбор видео с нескольких каналовСобирайте обычные публичные видео по нескольким URL каналов в одном запросе.
- Лимит результатов на каналЗадавайте отдельный results_limit для каждого входного канала, по умолчанию 100.
- Нормализованные метаданные видеоВозвращает нормализованные идентификаторы видео, метаданные контента, превью, длительность, дату публикации и канал, опубликовавший видео.
- Метрики вовлеченности на момент сбораВключает публичное число просмотров, лайков и комментариев вместе с collected_at для последующего сравнения.
- Только обычные видеоИсключает Shorts и прямые эфиры, чтобы результат был сосредоточен на обычных видео канала.
Параметры YouTube Channel Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных каналов YouTube, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число подходящих записей, запрашиваемых для каждого входного URL. Положительное целое число, по умолчанию 100. |
Как использовать YouTube Channel Videos API
Выберите, насколько глубоко просматривать каждый канал, и соберите чистый каталог обычных видео. Пакет может содержать несколько каналов, но запрошенный лимит применяется к каждому из них.
- Подготовьте URL публичных каналов и решите, нужна ли вам свежая выборка или более глубокая загрузка истории.
- Отправьте urls и results_limit методом POST на /v1/youtube/channel-videos; помните, что лимит действует для каждого канала.
- Опрашивайте /v1/tasks/{task_id}, пока задача сбора каталога не перейдет в статус succeeded или failed.
- Группируйте возвращенные элементы по ID канала, удаляйте дубли по ID видео и листайте страницы, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Сценарии использования YouTube Channel Videos API
- Ленты контента каналов: Создавайте структурированную ленту обычных публичных видео выбранных каналов.
- Анализ публикаций и результатов: Сравнивайте частоту публикаций, длительность, темы и публичную вовлеченность разных каналов.
- Мониторинг авторов и конкурентов: Отслеживайте активность обычных видео у авторов, издателей, брендов или конкурентов.
- Создание каталога видео: Наполняйте процессы классификации, резюмирования, поиска или отчетности, не собирая URL каждого видео вручную.
Практические советы по YouTube Channel Videos API
- Лимит умножается на число входных данных. Десять каналов с results_limit 100 запрашивают до 1 000 записей обычных видео.
- Подключая новый набор каналов, начните с небольшой глубины, проверьте, что подходит под отбор, и увеличивайте лимит только там, где полезна более глубокая история.
- Меньшее число результатов может означать, что у канала меньше подходящих публичных загрузок. Это не обязательно указывает на сбой задачи.
- Не представляйте ответ как гарантированно полный архив: доступность и публичный каталог канала могут меняться.
- Используйте ID видео для дедупликации и сохраняйте ID исходного канала и collected_at для анализа в динамике.
- Если важно соотношение форматов, собирайте Shorts отдельно. Объединение двух наборов только после сбора сохраняет классификацию явной.
- Для актуальных полей профиля используйте Channels, а не копируйте описания и счетчики канала в каждую строку загрузки.
Связанные API
Помимо YouTube Channel Videos API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Channel Live Videos API — Собирайте публичные записи трансляций из разделов прямых эфиров канала с контекстом источника и видимыми метриками.
- 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