YouTube Trending Shorts
Трендовые Shorts — это вертикальные видео, которые YouTube в данный момент продвигает на широкую аудиторию, и у каждого из них есть название, канал-автор, число просмотров, лайков и комментариев, длительность и точное время публикации. Вместе эти сигналы показывают, какие темы, форматы и авторы набирают популярность и как быстро ролик Shorts собирает просмотры после публикации.
Возможности YouTube Trending Shorts API
- Прямо из пула трендовЗаполнять ничего не нужно: каждый запуск берет ролики Shorts, которые YouTube продвигает в этот момент, около 48 за одну выборку, а повторные выборки объединяются без дублей до results_limit.
- Три счетчика вовлеченности для каждого ролика Shortsmetrics содержит точное число просмотров и лайков, а также число комментариев в том виде, в котором его показывает YouTube, поэтому ролик Shorts с активным обсуждением выделяется на фоне того, который только смотрят.
- Канал для каждого ролика Shortsauthor содержит ID канала, handle, название, URL и аватар, готовые для передачи в эндпоинты уровня канала.
- Время публикации и длительностьpublished_at — это точное время загрузки в UTC, а duration_seconds — длительность ролика; вместе они показывают, насколько свежий и длинный трендовый ролик Shorts.
- Хештеги, извлеченные из подписиХештеги, написанные в названии или описании, перечислены в hashtags без начального #.
Параметры YouTube Trending Shorts API
| Параметры | Обязательный | Описание |
|---|---|---|
results_limit | Необязательный | Сколько трендовых роликов Shorts вернуть: от 1 до 200. По умолчанию 48. |
Как использовать YouTube Trending Shorts API
Отправьте необязательное число результатов, затем читайте ролики Shorts после завершения задачи.
- Отправьте {"results_limit": 48} методом POST на /v1/youtube/trending-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/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit":48}'
# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.Сценарии использования YouTube Trending Shorts API
- Ежедневные снимки трендов: Запускайте эндпоинт в заданное время и сохраняйте каждую партию, чтобы видеть, какие темы и форматы постоянно появляются в трендовых Shorts.
- Поиск авторов на взлете: Сравнивайте views_count с published_at, чтобы находить каналы, чьи свежие ролики набирают миллионы просмотров за считаные дни.
- Мониторинг хештегов в Shorts: Подсчитывайте хештеги по трендовым роликам Shorts, чтобы увидеть, какие теги сопровождают вирусные короткие видео на этой неделе.
Практические советы по YouTube Trending Shorts API
- Каждый запуск дает новую выборку, поэтому сохраняйте id каждого ролика Shorts и пропускайте повторы, когда объединяете запуски с интервалом в несколько минут.
- Делите views_count на число часов с момента published_at, чтобы ранжировать ролики Shorts по скорости набора просмотров, а не по их общему числу.
- Отправляйте author.url в YouTube Channels, если вам также нужны число подписчиков и описания каналов.
Связанные API
Помимо YouTube Trending Shorts API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API