youtube/
related-videos

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

YouTube Related Videos API

URL видео на входе
Рекомендации «Далее»
Канал и просмотры
0,5 кредита за результат
Готово
README

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

YouTube Related Videos

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

Возможности YouTube Related Videos API

  • Любая распространенная ссылка на видеоID видео извлекается из ссылок watch, коротких ссылок youtu.be, ссылок на ролики Shorts и на прямые эфиры.
  • Весь список за один запускОдна задача возвращает полный список рекомендаций, который YouTube показывает для этого видео, обычно около 20 роликов.
  • Автор каждой рекомендацииauthor содержит ID канала, название и URL канала каждого рекомендованного видео.
  • Просмотры и превьюmetrics.views_count извлекается из отображаемого на YouTube счетчика, например 2.2M, а media содержит превью максимального размера.

Параметры YouTube Related Videos API

ПараметрыОбязательныйОписание
urlОбязательныйСсылка на видео YouTube: URL watch, ссылка youtu.be, ссылка на ролик Shorts или на прямой эфир.

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

Отправьте одну ссылку на видео и получите рекомендации.

  1. Отправьте {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} методом POST на /v1/youtube/related-videos.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте рекомендации из results.items и переходите по results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# Each item is one recommended video with author and metrics.views_count.

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

  • Карта ниши вокруг видео: Начните с сильного видео, соберите его рекомендации, затем повторите сбор для полученных роликов, чтобы составить карту кластера видео, которые YouTube группирует вместе.
  • Поиск конкурирующих каналов: Подсчитайте, как часто каждый author.id появляется рядом с вашими роликами, чтобы увидеть, какие каналы YouTube постоянно рекомендует рядом с вами.
  • Где рекомендуется ваше видео: Запускайте эндпоинт для популярных видео конкурентов и ищите ID своих видео в их списках.

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

  • Считайте views_count приблизительным значением: оно получено из округленного отображаемого текста вроде 2.2M.
  • Рекомендации со временем меняются, поэтому при сравнении запусков сохраняйте collected_at с каждым списком.
  • Отправляйте URL отобранных видео в YouTube Videos, чтобы получить точные счетчики, даты публикации и длительность.

Помимо YouTube Related Videos 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 Related Videos API — FAQ

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

Он возвращает весь список, который YouTube показывает для этого видео, обычно около 20 роликов.

Да. Принимаются ссылки на ролики Shorts, ссылки youtu.be, ссылки на прямые эфиры и обычные URL watch.

Уже нет. Официальный Data API прекратил поддержку параметра поиска relatedToVideoId 7 августа 2023 года, поэтому этот эндпоинт — способ получить список, который YouTube показывает рядом с видео.

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