YouTube Videos
Видео YouTube — это публичные загрузки с названиями, описаниями, контекстом канала, превью, длительностью, сведениями о публикации, хештегами, классификацией источника и видимой вовлеченностью. Эти метаданные и показатели результатов помогают обогащать данные о видео, исследовать контент, вести мониторинг и проводить сравнительный анализ.
Возможности YouTube Videos API
- Пакетный поиск по известным URLПолучайте данные по нескольким известным URL публичных видео и роликов Shorts в одном запросе.
- Стабильная идентификация видеоВозвращает для каждого результата стабильный ID видео, канонический URL, название, публичное описание и канал, опубликовавший видео.
- Метаданные контентаВключает превью, длительность, хештеги, дату публикации и нормализованный тип контента.
- Метрики вовлеченности на момент сбораФиксирует публичное число просмотров, лайков и комментариев вместе с collected_at для сравнения на определенный момент.
- Единая схема видеоПредоставляет одну и ту же нормализованную структуру для обычных видео и поддерживаемых URL роликов Shorts.
Параметры YouTube Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных видео или роликов Shorts на YouTube, разделенные запятыми или переводами строки. |
Как использовать YouTube Videos API
Превратите собранные ссылки в записи, которые ваше приложение может связывать, искать и обновлять. Запрос асинхронный, поэтому сохраняйте ID задачи, пока не будут обработаны все доступные URL.
- Соберите URL публичных видео (watch) или Shorts и удалите дубли; URL каналов и страниц результатов поиска обрабатываются другими эндпоинтами.
- Отправьте массив urls методом POST на /v1/youtube/videos и сохраните возвращенный task_id рядом со своим исходным пакетом.
- Опрашивайте /v1/tasks/{task_id}; queued и running означают, что пакет еще обрабатывается.
- После успешного завершения проиндексируйте data.results.items по id и продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Сценарии использования YouTube Videos API
- Обогащение списков URL: Добавляйте названия, сведения о канале, превью, длительность, даты публикации и публичные метрики к существующему списку URL YouTube.
- Сравнение выбранных видео: Сравнивайте публичные просмотры, лайки, комментарии, длительность и сведения о публикации в выбранном наборе видео или роликов Shorts.
- Мониторинг кампаний и конкурентов: Собирайте повторные снимки метаданных известных видео кампаний, авторов или конкурентов.
- Каталоги контента: Передавайте нормализованные записи видео во внутренние процессы поиска, отчетности, модерации, резюмирования или аналитики.
Практические советы по YouTube Videos API
- Сделайте id первичным ключом. Названия могут меняться, а одно и то же видео может прийти через несколько допустимых форматов URL.
- Используйте canonical_url для внешних ссылок, но сохраняйте input_url, если нужно проследить, откуда пришла запись.
- Метрики описывают страницу на момент collected_at. Сравнивать два снимка полезно, а перезапись старого уничтожает эту историю.
- Считайте ссылки из описания недоверенными внешними данными, прежде чем отображать, обходить или импортировать их.
- Отсутствие результата не доказывает, что URL никогда не существовал. Приватные, удаленные, ограниченные или временно недоступные элементы могут выпасть из пакета.
- Комментарии и текст расшифровок намеренно вынесены отдельно. Запрашивайте их только для элементов, которые доходят до этих этапов вашего процесса.
- Для поиска по теме начните с Search. Используйте Videos, когда уже знаете, какой URL важен.
Связанные API
Помимо YouTube Videos API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Related Videos API — Получайте видео, которые YouTube рекомендует рядом с роликом по его URL: названия, каналы, просмотры и миниатюры.
- 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 Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API