YouTubeYouTube Shortsпубликации сообществааутрич к авторамруководство по API

Новые эндпоинты YouTube API: трендовые Shorts, публикации сообщества, поиск каналов и email

Восемь новых эндпоинтов SocQ для YouTube возвращают трендовые Shorts, поиск Shorts и каналов, поисковые подсказки, публикации сообщества и комментарии к ним, похожие видео и рабочие email каналов.

SocQОбновлено 19 ноября 2026 г.7 мин чтения

SocQ уже возвращал публичные каналы YouTube, видео, Shorts, комментарии, поиск, плейлисты и транскрипты. Их сравнение — в статье 7 лучших API для парсинга YouTube, а массовое получение текста субтитров описано в руководстве по транскриптам YouTube. 2026-11-17 на странице платформы YouTube заработали еще восемь эндпоинтов. Они закрывают пробелы в исследовании Shorts, поиске авторов и аутриче, а также в работе с публикациями сообщества, которые авторы выпускают между загрузками видео.

В этом руководстве новые эндпоинты сгруппированы по задачам: для каждого приведены один запрос, цена и сценарий использования.

Коротко: отправьте JSON-тело на POST https://api.socq.ai/v1/youtube/<endpoint>. Сохраните возвращенный task_id, опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items.

Новые эндпоинты YouTube вкратце

1 кредит SocQ = $0.005. У эндпоинтов с оплатой за результат нет базовой платы, поэтому пустой результат ничего не стоит.

ЭндпоинтЧто возвращаетЦена
YouTube Trending Shorts APIСвежая выборка трендовых Shorts с каналом, просмотрами, лайками, комментариями, длительностью и временем публикации0.5 кредита ($0.0025) за Short
YouTube Shorts Search APIShorts по ключевому слову со ссылкой, подписью, просмотрами и вертикальной миниатюрой0.6 кредита ($0.003) за Short
YouTube Channel Search APIКаналы по ключевому слову с ID, названием, подписчиками, аватаром и фрагментом описания0.6 кредита ($0.003) за канал
YouTube Search Suggestions APIРанжированные подсказки автодополнения для неполного запроса с учетом языка и региона0.5 кредита ($0.0025) за вызов
YouTube Community Post APIОдна публикация сообщества: полный текст, все изображения, лайки и канал0.5 кредита ($0.0025) за вызов
YouTube Community Post Comments APIКомментарии под публикацией сообщества с комментатором, лайками и числом ответов0.3 кредита ($0.0015) за комментарий
YouTube Related Videos APIВидео, которые YouTube рекомендует рядом с видео0.5 кредита ($0.0025) за видео
YouTube Email Finder APIПубличные рабочие email канала и страницы, на которых они найдены15 кредитов ($0.075) за канал с email; бесплатно, если email не найден

Аутентификация и асинхронные задачи

Все запросы аутентифицируются API-ключом. Один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Вызов отправки сразу возвращает data.task_id и data.status. Опрашивайте задачу по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит result_count, credits_amount и первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если results.has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Задача с ошибкой содержит error_message.

Каждый эндпоинт ниже также принимает необязательный callback_url. SocQ отправит один POST со сводкой задачи после ее завершения; записи читайте через эндпоинт задачи. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не отправляйте ее повторно. 402 означает, что у аккаунта закончились кредиты, а 429 — что ключ достиг лимита запросов или кредитов.

Исследование Shorts и поискового спроса

Trending Shorts делает выборку Shorts, которые YouTube прямо сейчас показывает как трендовые, каждый с названием, каналом, просмотрами, лайками, комментариями, длительностью и временем публикации. Все поля необязательны; по умолчанию results_limit равен 48, максимум 200. Каждый запуск делает свежую выборку, поэтому у двух запусков с разницей в несколько минут совпадает лишь горстка Shorts. Поэтому задача по расписанию дает за день более широкую картину, чем один большой вызов. (документация)

curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit": 48}'

Shorts Search возвращает Shorts по ключевому слову в порядке поиска YouTube, со ссылкой, подписью, числом просмотров и вертикальной миниатюрой. Результаты поиска содержат только эти базовые данные, поэтому передавайте сохраненные ссылки в YouTube Videos, если вам также нужны лайки, комментарии или данные канала. По умолчанию results_limit равен 25 (от 1 до 200). (документация)

curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "meal prep", "results_limit": 25}'

Search Suggestions возвращает варианты автодополнения, которые поисковая строка YouTube предлагает для начала запроса, в том порядке, в каком их видят зрители. language по умолчанию en, а region — US; меняйте их, чтобы увидеть, как тот же исходный запрос разветвляется на другом рынке. Каждый вызов оплачивается один раз независимо от числа подсказок. Используйте его для исследования ключевых слов, заголовков и тегов. (документация)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

Поиск авторов и их контактных email

Channel Search находит каналы по ключевому слову в порядке YouTube, с ID канала, названием, числом подписчиков, аватаром и фрагментом описания, показанным в результатах. По умолчанию results_limit равен 20 (от 1 до 200). Это первый шаг поиска авторов: составьте шорт-лист здесь, затем получите подробности через YouTube Channels или загрузки через YouTube Channel Videos. (документация)

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}'

Email Finder ищет рабочие email, которые опубликовал автор: в описании канала, в связанных профилях соцсетей, на страницах link-in-bio или на собственном сайте автора. Каждый адрес в emails возвращается вместе с source_urls, на которых он найден. url принимает ссылку на канал в форме @handle или /channel/UC.... Канал хотя бы с одним публичным email возвращает один результат со всеми найденными адресами и стоит 15 кредитов ($0.075); канал без email возвращает пустой результат бесплатно. (документация)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

Пример расчета: найдите 20 каналов (12 кредитов), затем запустите Email Finder для всех 20. Если у 8 из них указан email, это 120 кредитов, итого 132 кредита ($0.66). За 12 каналов без публичного email вы ничего не платите.

Публикации сообщества и комментарии к ним

Community Post читает одну публикацию по ссылке: полный текст, все прикрепленные изображения, число лайков и опубликовавший канал. url принимает ссылку https://www.youtube.com/post/{post_id} или ссылку на вкладку публикаций канала с ?lb={post_id}. Используйте его, когда у вас уже есть URL публикации, например из результата YouTube Community Posts. (документация)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments собирает комментарии под публикацией — опросом, анонсом или подборкой изображений — с каналом каждого комментатора, metrics.likes_count и metrics.replies_count. Комментарии к публикациям хранятся отдельно от комментариев к видео, поэтому именно так можно прочитать реакцию на обновления автора между загрузками. Подходят те же формы URL; по умолчанию results_limit равен 100 (от 1 до 1000). (документация)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

Что YouTube рекомендует дальше

Related Videos возвращает список, который YouTube размещает рядом с видео как рекомендацию к просмотру: названия, каналы, число просмотров и миниатюры. url принимает ссылку на просмотр, youtu.be, Shorts или трансляцию. Один запуск возвращает весь список рекомендаций, обычно около 20 видео, с оплатой за видео, поэтому типичный вызов стоит около 10 кредитов ($0.05). Запускайте его для своих загрузок или для видео конкурента, чтобы увидеть, какие видео и каналы YouTube считает их соседями. (документация)

curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

Другие руководства по YouTube

Чтобы сравнить SocQ с другими поставщиками данных YouTube, см. статью 19 лучших альтернатив YouTube API. Такой же сценарий поиска авторов и аутрича для TikTok, включая страны подписчиков и проверку накрученных просмотров, описан в руководстве по новым эндпоинтам TikTok.

FAQ

Платить ли за каналы без публичного email?

Нет. Канал без публичного email возвращает пустой результат, и это бесплатно. Канал хотя бы с одним email стоит 15 кредитов независимо от числа указанных адресов.

Каждый запуск делает выборку того, что в тренде в этот момент, поэтому у запусков с разницей в несколько минут совпадает лишь горстка Shorts. Если нужен более широкий охват, запланируйте несколько запусков.

Какие URL публикаций сообщества принимаются?

https://www.youtube.com/post/{post_id} или ссылка на вкладку публикаций канала с ?lb={post_id}.

Возвращает ли Shorts Search лайки и комментарии?

Нет. Результаты поиска содержат ссылку, подпись, число просмотров и миниатюру. Передавайте ссылки в YouTube Videos, чтобы получить лайки, комментарии и данные канала.

Как оплачивается Search Suggestions?

0.5 кредита за вызов независимо от числа возвращенных подсказок.

YOUTUBE API

Проверить сценарий на публичном URL YouTube

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для YouTube