youtube/
trending-shorts

Получайте выборку роликов Shorts, которые сейчас в тренде на YouTube, без входных данных: названия, каналы, просмотры, лайки, комментарии, длительность и точное время публикации.

YouTube Trending Shorts API

Без входных данных
Новая выборка при каждом запуске
Просмотры, лайки, комментарии
0,5 кредита за результат
Готово
README

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

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 после завершения задачи.

  1. Отправьте {"results_limit": 48} методом POST на /v1/youtube/trending-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/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, если вам также нужны число подписчиков и описания каналов.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

YouTube Trending Shorts API — FAQ

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

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

Задайте results_limit в диапазоне от 1 до 200; по умолчанию 48, что примерно соответствует одной выборке из пула трендов.

Для просмотров и лайков — да: views_count и likes_count — это полные целые числа, взятые из каждого ролика Shorts. comments_count следует значению, которое показывает YouTube, поэтому значения больше тысячи округляются, например 4800 для 4.8K, а лайки или комментарии имеют значение null, если автор их скрыл.

Параметра страны нет. Каждый запуск возвращает ролики Shorts, находящиеся в пуле трендов в этот момент, поэтому планируйте запуски и объединяйте их по id, чтобы следить за изменениями пула.

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