youtube/
shorts

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

YouTube Shorts API

Shorts
Сбор по каналам
Публичные метрики
0,5 кредита за результат
Готово
Готово

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

README

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

YouTube Shorts

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

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

  • Сбор Shorts с нескольких каналовСобирайте публичные Shorts по нескольким URL каналов в одном запросе.
  • Лимит результатов на каналЗадавайте отдельный results_limit для каждого входного канала, по умолчанию 100.
  • Нормализованные метаданные ShortsВозвращает нормализованные идентификаторы роликов Shorts, метаданные контента, превью, длительность, дату публикации и канал, опубликовавший ролик.
  • Метрики вовлеченности на момент сбораВключает публичное число просмотров, лайков и комментариев вместе с collected_at для последующего сравнения.
  • Shorts по классификации платформыИспользует классификацию Shorts самого YouTube, а не определяет короткий контент только по длительности или ориентации.

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

ПараметрыОбязательныйОписание
urlsОбязательныйURL публичных каналов YouTube, разделенные запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число подходящих записей, запрашиваемых для каждого входного URL. Положительное целое число, по умолчанию 100.

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

Создайте чистый поток коротких видео для известного набора каналов. Задача отделяет классификацию платформы от собственных правил формата, которые вы можете применить позже.

  1. Подготовьте URL публичных каналов; отдельные URL роликов Shorts передавайте в Videos, если нужен прямой поиск.
  2. Отправьте urls и results_limit методом POST на /v1/youtube/shorts, учитывая, что лимит действует для каждого канала.
  3. Опрашивайте /v1/tasks/{task_id}, пока сбор по каналам не завершится.
  4. Индексируйте результаты по ID ролика Shorts, сохраняйте контекст канала и сбора и листайте страницы, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

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

  • Мониторинг активности в коротком формате: Отслеживайте публичные Shorts, опубликованные выбранными авторами, брендами, издателями или конкурентами.
  • Сравнение результатов Shorts: Сравнивайте частоту публикаций, длительность, просмотры, лайки и комментарии у выбранных каналов.
  • Каталоги короткого контента: Создавайте нормализованную подборку публичных Shorts для внутреннего поиска, проверки или отчетности.
  • Анализ тем и трендов: Используйте названия, описания, хештеги, данные каналов и публичные метрики в процессах классификации или исследования.

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

  • Не переклассифицируйте результаты по универсальному порогу длительности. Спецификацией для этого эндпоинта служит публичная классификация форматов YouTube.
  • Лимит действует на канал и является верхней границей, а не гарантией. У некоторых каналов мало подходящих публичных Shorts или их нет вовсе.
  • Используйте возвращенный ID для дедупликации: один и тот же ролик может появляться в других частях вашей системы под разными публичными URL.
  • Храните collected_at вместе с метриками, потому что видимые счетчики ролика Shorts могут быстро меняться после публикации.
  • Этот эндпоинт не ищет по ключевым словам. Для поиска тем начните с Search, а затем при необходимости передавайте известные URL роликов Shorts в Videos.
  • Собирайте Channel Videos отдельно, если нужно чистое сравнение коротких и обычных публикаций.
  • Связывайте с Channels по ID канала для полей профиля и аудитории, а не повторяйте изменчивые метаданные канала в каждом элементе.

Помимо YouTube 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 Channel Live Videos API — Собирайте публичные записи трансляций из разделов прямых эфиров канала с контекстом источника и видимыми метриками.

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

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

YouTube Shorts API — FAQ

YouTube Shorts API собирает публично доступные Shorts по одному или нескольким URL каналов YouTube. Он возвращает нормализованные названия, сведения о канале, превью, длительность, даты публикации, метрики вовлеченности и время сбора.

Передайте один или несколько URL публичных каналов YouTube и необязательный results_limit.

Эндпоинт опирается на классификацию Shorts самого YouTube, а не только на фиксированное правило длительности или соотношения сторон.

По умолчанию results_limit равен 100 и применяется отдельно к каждому URL канала. Итоговое число может быть меньше, если у канала меньше подходящих публичных Shorts.

Нет. Просмотры, лайки и комментарии — это публичные значения, зафиксированные на момент сбора. Для исторического сравнения нужны повторные сборы.

Каждый возвращенный нормализованный результат Shorts стоит 0,5 кредита.