youtube/
channels

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

YouTube Channels API

Каналы
Публичные профили
Видимые метрики
0,26 кредита за результат
Готово
Готово

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

README

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

YouTube Channels

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

Возможности YouTube Channels API

  • Сбор профилей нескольких каналовСобирайте публичные профили по нескольким URL каналов в одном запросе.
  • Нормализованные данные о каналеВозвращает ID канала, handle, отображаемое имя, канонический URL, описание, аватар и баннер в единой структуре.
  • Публичные метрики каналаВключает статус верификации, публичное число подписчиков, число опубликованных видео и общее число просмотров канала.
  • Контекстные поля профиляСохраняет публичное местоположение, ссылки профиля, дату создания канала и переданный URL канала.
  • Временные метки сбораДобавляет collected_at к каждому результату, чтобы сохраненные записи можно было сравнивать по датам сбора.

Параметры YouTube Channels API

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

Как использовать YouTube Channels API

Превратите список публичных страниц каналов в долговременные записи о каналах. Запрос асинхронный, поэтому сохраняйте ID задачи, пока не будут обработаны все переданные каналы.

  1. Составьте список URL публичных каналов или @handle без дублей — не URL страниц просмотра видео.
  2. Отправьте массив urls методом POST на /v1/youtube/channels и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}; queued и running — обычные промежуточные статусы.
  4. Когда задача завершится успешно, проиндексируйте data.results.items по id и продолжайте с next_cursor, если has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"]}'

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

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

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

Практические советы по YouTube Channels API

  • Храните id как первичный ключ. Handle удобен для отображения и маршрутизации, но может измениться без создания нового канала.
  • Не превращайте скрытое число подписчиков в 0. Null означает, что значение не было публично доступно, а это другой бизнес-сигнал.
  • Считайте ссылки из описания недоверенными внешними URL. Проверяйте и очищайте их, прежде чем показывать во внутреннем инструменте.
  • Сравнивайте счетчики аудитории, только если есть collected_at, и для расчета трендов собирайте данные с постоянной периодичностью.
  • Успешный пакет может содержать меньше записей, чем было URL, если канал удален, ограничен или больше не является публичным.
  • Связывайте Channels с Channel Videos или Shorts по ID канала, а не повторяйте поля профиля в каждой строке контента.

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

  • YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
  • YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
  • YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
  • YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
  • YouTube Community Posts API — Собирайте публикации в сообществе по URL каналов: текст, данные канала, метки времени, ссылки на изображения и контекст источника.
  • YouTube Email Finder API — Находите по URL канала его публичные деловые email-адреса и страницы, на которых указан каждый адрес.

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

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

YouTube Channels API — FAQ

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

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

Да. Добавьте несколько URL публичных каналов в один массив urls, чтобы собрать их записи профилей вместе.

Канал может скрыть число подписчиков, а необязательные публичные поля профиля есть не у каждого канала. Отсутствующие публичные значения остаются пустыми и не выдаются за ноль.

Нет. Этот эндпоинт возвращает данные профиля канала и сводную статистику. Для обычных загрузок используйте Channel Videos, а для Shorts канала — Shorts.

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