youtube/
search-shorts

Ищите YouTube Shorts по ключевому слову и получайте для каждого ролика Shorts ссылку, подпись, число просмотров, вертикальное превью и хештеги из подписи в порядке поисковой выдачи YouTube.

YouTube Shorts Search API

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

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

README

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

YouTube Shorts Search

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

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

  • Только Shorts и ничего большеРезультаты берутся из поиска Shorts на YouTube, поэтому длинные видео, каналы и плейлисты в список не попадают.
  • Подпись, просмотры и превьюtext — это подпись ролика Shorts, metrics.views_count извлекается из отображаемого счетчика, а media содержит вертикальное превью с его размером.
  • Хештеги из подписиХештеги, написанные в подписи, перечислены в hashtags и готовы для подсчета по всему набору результатов.
  • Готовые ссылки на ShortsКаждый результат содержит URL вида youtube.com/shorts/ и ID видео для последующих запросов.

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

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

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

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

  1. Отправьте {"query": "meal prep", "results_limit": 25} методом POST на /v1/youtube/search-shorts.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте ролики Shorts из results.items и переходите по results.next_cursor, пока has_more равно true.
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}'

# Each item is one Short with text, metrics.views_count and a shorts URL.

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

  • Исследование зацепок по теме: Читайте подписи самых просматриваемых роликов Shorts по ключевому слову, чтобы увидеть, какие начала и обещания собирают просмотры.
  • Отслеживание ключевого слова в Shorts: Повторяйте один и тот же поиск по расписанию и сравнивайте, какие ID видео появляются в результатах или выпадают из них.
  • Сбор Shorts для углубленного анализа: Соберите URL роликов Shorts по теме и передайте их в YouTube Videos, чтобы получить канал, лайки и дату публикации.

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

  • Результаты поиска содержат только подпись и число просмотров, поэтому отправляйте отобранные URL в YouTube Videos, когда нужны канал или лайки.
  • Число просмотров берется из округленного отображаемого текста вроде 635K, поэтому сравнивайте значения по порядку величины, а не как точные итоги.
  • Последующие страницы повторяют часть роликов Shorts с предыдущих, поэтому результаты очищаются от дублей по ID видео до того, как засчитываются в results_limit.

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

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

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

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

YouTube Shorts Search API — FAQ

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

Отправьте URL ролика Shorts в YouTube Videos: этот эндпоинт возвращает канал, лайки, комментарии и дату публикации для каждого видео.

Задайте results_limit от 1 до 200; по умолчанию 25, что примерно соответствует одной странице результатов Shorts.

В его поиске нет фильтра только для Shorts, а videoDuration=short подходит для любого видео короче четырех минут. Этот эндпоинт берет результаты из поиска Shorts на YouTube, поэтому каждый возвращаемый элемент — ролик Shorts.

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