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
Отправьте одну ссылку на видео и получите рекомендации.
- Отправьте {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} методом POST на /v1/youtube/related-videos.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте рекомендации из 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, чтобы получить точные счетчики, даты публикации и длительность.
Связанные API
Помимо 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 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