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 API | Shorts по ключевому слову со ссылкой, подписью, просмотрами и вертикальной миниатюрой | 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 кредитов независимо от числа указанных адресов.
Почему два запуска Trending Shorts возвращают разные Shorts?
Каждый запуск делает выборку того, что в тренде в этот момент, поэтому у запусков с разницей в несколько минут совпадает лишь горстка 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