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.
- Отправьте {"query": "meal prep", "results_limit": 25} методом POST на /v1/youtube/search-shorts.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте ролики 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.
Связанные API
Помимо 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 Channel Videos API
- YouTube Transcripts API
- YouTube Channels 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 Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API