YouTube Channels
Каналы YouTube — это публичные страницы авторов, брендов или организаций с данными о канале, описаниями, изображениями, верификацией, ссылками профиля и видимым общим числом подписчиков, видео и просмотров. Эти сведения о каналах помогают изучать авторов, сравнивать аудитории, обогащать каталоги и анализировать рынок.
Возможности YouTube Channels API
- Сбор профилей нескольких каналовСобирайте публичные профили по нескольким URL каналов в одном запросе.
- Нормализованные данные о каналеВозвращает ID канала, handle, отображаемое имя, канонический URL, описание, аватар и баннер в единой структуре.
- Публичные метрики каналаВключает статус верификации, публичное число подписчиков, число опубликованных видео и общее число просмотров канала.
- Контекстные поля профиляСохраняет публичное местоположение, ссылки профиля, дату создания канала и переданный URL канала.
- Временные метки сбораДобавляет collected_at к каждому результату, чтобы сохраненные записи можно было сравнивать по датам сбора.
Параметры YouTube Channels API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных каналов YouTube, разделенные запятыми или переводами строки. |
Как использовать YouTube Channels API
Превратите список публичных страниц каналов в долговременные записи о каналах. Запрос асинхронный, поэтому сохраняйте ID задачи, пока не будут обработаны все переданные каналы.
- Составьте список URL публичных каналов или @handle без дублей — не URL страниц просмотра видео.
- Отправьте массив urls методом POST на /v1/youtube/channels и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}; queued и running — обычные промежуточные статусы.
- Когда задача завершится успешно, проиндексируйте 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 канала, а не повторяйте поля профиля в каждой строке контента.
Связанные API
Помимо 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 Videos API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies 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 Trending Videos API