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
Выполните поиск по ключевому слову и постранично просматривайте подходящие каналы.
- Отправьте {"query": "home cooking", "results_limit": 20} методом POST на /v1/youtube/search-channels.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте каналы из 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, чтобы узнать, публикуют ли они деловой контакт.
Связанные API
Помимо 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 Comments API
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Trending Videos API