youtube/
videos

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

YouTube Videos API

Данные видео
Известные URL
Публичные метрики
0,5 кредита за результат
Готово
Готово

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

README

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

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.

  1. Соберите URL публичных видео (watch) или Shorts и удалите дубли; URL каналов и страниц результатов поиска обрабатываются другими эндпоинтами.
  2. Отправьте массив urls методом POST на /v1/youtube/videos и сохраните возвращенный task_id рядом со своим исходным пакетом.
  3. Опрашивайте /v1/tasks/{task_id}; queued и running означают, что пакет еще обрабатывается.
  4. После успешного завершения проиндексируйте 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 важен.

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

YouTube Videos API — FAQ

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

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

Да. Публичные URL роликов Shorts поддерживаются и используют ту же нормализованную структуру видео с сохранением типа контента.

Нет. Метрики — это публичные значения, зафиксированные на момент сбора. Сохраняйте collected_at и собирайте те же URL повторно, если нужны исторические сравнения.

Результат видео включает публичное число комментариев, но не текст комментариев и не текст расшифровки. Для записей комментариев используйте Comments, а для доступных субтитров — Transcripts.

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