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
Создайте чистый поток коротких видео для известного набора каналов. Задача отделяет классификацию платформы от собственных правил формата, которые вы можете применить позже.
- Подготовьте URL публичных каналов; отдельные URL роликов Shorts передавайте в Videos, если нужен прямой поиск.
- Отправьте urls и results_limit методом POST на /v1/youtube/shorts, учитывая, что лимит действует для каждого канала.
- Опрашивайте /v1/tasks/{task_id}, пока сбор по каналам не завершится.
- Индексируйте результаты по 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 канала для полей профиля и аудитории, а не повторяйте изменчивые метаданные канала в каждом элементе.
Связанные API
Помимо 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 Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts 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