youtube/
channel-videos

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

YouTube Channel Videos API

Видео канала
Обычные загрузки
Публичные метрики
0,5 кредита за результат
Готово
Готово

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

README

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

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

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

  1. Подготовьте URL публичных каналов и решите, нужна ли вам свежая выборка или более глубокая загрузка истории.
  2. Отправьте urls и results_limit методом POST на /v1/youtube/channel-videos; помните, что лимит действует для каждого канала.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача сбора каталога не перейдет в статус succeeded или failed.
  4. Группируйте возвращенные элементы по 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, а не копируйте описания и счетчики канала в каждую строку загрузки.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

YouTube Channel Videos API — FAQ

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

Передайте один или несколько URL публичных каналов YouTube и необязательный results_limit.

По умолчанию results_limit равен 100 и применяется отдельно к каждому URL канала. Итоговое число может быть меньше, если у канала меньше подходящих публичных обычных видео.

Нет. Этот эндпоинт возвращает обычные видео канала. Для Shorts канала используйте Shorts.

Нет. Просмотры, лайки и комментарии — это публичные значения, зафиксированные на момент сбора. Для исторических сравнений нужны повторные сборы.

Каждый возвращенный нормализованный результат видео стоит 0,5 кредита.