youtube/
search-channels

Ищите каналы YouTube по ключевому слову и получайте ID каналов, названия, число подписчиков, аватары и фрагмент описания, который показывает YouTube, в порядке поисковой выдачи.

YouTube Channel Search API

Ключевое слово на входе
Число подписчиков
До 200 каналов
0,6 кредита за результат
Готово
Готово

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

README

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

YouTube Channel Search

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

Возможности YouTube Channel Search API

  • Только каналыПоиск ограничен каналами, поэтому ключевое слово вроде home cooking возвращает аккаунты авторов, а не смесь видео и плейлистов.
  • Число подписчиков каждого каналаmetrics.followers_count содержит общее число подписчиков, извлеченное из отображаемого на YouTube значения, например 3.69M.
  • Стабильные ID каналов и ссылкиКаждый результат содержит ID канала вида UC и построенный на его основе URL канала, готовый для эндпоинтов уровня канала.
  • Фрагмент описанияtext содержит отрывок описания, показанный в поиске, который часто указывает нишу или включает деловой контакт.

Параметры YouTube Channel Search API

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово для поиска каналов, до 100 символов.
results_limitНеобязательныйСколько каналов вернуть: от 1 до 200. По умолчанию 20.

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

Выполните поиск по ключевому слову и постранично просматривайте подходящие каналы.

  1. Отправьте {"query": "home cooking", "results_limit": 20} методом POST на /v1/youtube/search-channels.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте каналы из results.items и передавайте results.next_cursor обратно, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

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

  • Шорт-лист авторов: Ищите по ключевым словам своей ниши и оставляйте каналы, у которых followers_count попадает в нужный вам диапазон размеров.
  • Кто владеет темой: Сравните число подписчиков у первых результатов по ключевому слову, чтобы понять, доминируют ли в теме несколько крупных каналов.
  • Отправная точка для исследования каналов: Передавайте полученные URL каналов в YouTube Channels и YouTube Channel Videos, чтобы подробно изучить каждого автора.

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

  • Число подписчиков берется из округленного отображаемого текста, поэтому используйте YouTube Channels, если нужна точная цифра.
  • Запускайте поиск по нескольким формулировкам темы и объединяйте результаты по id канала, чтобы расширить список.
  • Передавайте перспективные каналы в YouTube Email Finder, чтобы узнать, публикуют ли они деловой контакт.

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

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

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

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

YouTube Channel Search API — FAQ

YouTube Channel Search API — это программный интерфейс для поиска каналов YouTube, соответствующих ключевому слову. Он возвращает ID каналов, названия, число подписчиков, аватары и фрагменты описаний в порядке поисковой выдачи YouTube.

Задайте results_limit от 1 до 200; по умолчанию 20. Результаты автоматически собираются постранично, пока не будет достигнут лимит или конец выдачи YouTube.

Результаты поиска идентифицируют каналы по ID вида UC и URL канала. Отправьте этот URL в YouTube Channels, чтобы получить handle и полный профиль.

Нет. Запросы используют ваш API-ключ SocQ и оплачиваются кредитами за каждый возвращенный канал, поэтому не нужно управлять проектом Google Cloud или дневной квотой.

Каждый возвращенный канал стоит 0,6 кредита, поэтому 20 каналов по умолчанию стоят 12 кредитов.