youtube/
related-videos

The YouTube Related Videos API lists the videos YouTube recommends next to a video from its URL, returning each recommendation's title, channel, view count, and thumbnail in one run.

YouTube Related Videos API

Video URL input
Up next recommendations
Channel and views
0.5 credits / result
Ready
README

By SocQ · Updated

YouTube Related Videos

Related videos are the recommendations YouTube lines up beside a video as what to watch next, each shown with its title, channel, view count and thumbnail. That list reveals which videos and channels YouTube places in the same neighbourhood, which is useful for mapping a niche, finding competing channels and planning content that sits next to a target video.

YouTube Related Videos API Features

  • Any common video linkWatch URLs, youtu.be short links, Shorts links and live links are all read for their video ID.
  • The whole list in one runOne task returns the full recommendation list YouTube shows for that video, usually about 20 videos.
  • Who made each recommendationauthor holds the channel ID, name and channel URL behind every recommended video.
  • Views and thumbnailmetrics.views_count is parsed from YouTube's display count, such as 2.2M, and media gives the largest thumbnail.

YouTube Related Videos API Parameters

ParametersRequiredDescription
urlRequiredA YouTube video link: a watch URL, youtu.be link, Shorts link or live link.

How to Use the YouTube Related Videos API

Send one video link and read the recommendations back.

  1. POST {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} to /v1/youtube/related-videos.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the recommendations from results.items, following results.next_cursor while has_more is 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 Use Cases

  • Mapping a niche around a video: Start from a strong video and collect its recommendations, then repeat on those results to chart the cluster of videos YouTube groups together.
  • Finding competing channels: Count how often each author.id appears beside your own uploads to see which channels YouTube keeps recommending next to you.
  • Checking where your video is recommended: Run the endpoint on competitors' popular videos and look for your own video IDs in their lists.

YouTube Related Videos API Pro Tips

  • Treat views_count as an approximation: it comes from rounded display text like 2.2M.
  • Recommendations shift over time, so store collected_at with each list when you compare runs.
  • Send the video URLs you keep to YouTube Videos for exact counts, publish dates and durations.

Beyond the YouTube Related Videos API, use these APIs when you need a different type of public YouTube data.

  • YouTube Channel Videos API — Collect regular public videos from channel URLs, excluding Shorts and live streams.
  • YouTube Comments API — Collect public comments, authors, engagement, source videos, and conversation context.
  • YouTube Transcripts API — Retrieve available plain-text transcripts with optional language selection.
  • YouTube Channels API — Retrieve public channel identity, images, verification, and visible audience statistics.
  • YouTube Videos API — Retrieve metadata, thumbnails, duration, and engagement for known video or Short URLs.
  • YouTube Shorts API — Collect public Shorts, thumbnails, duration, publication details, and engagement by channel.

Explore other platforms

Combine YouTube data with public data from other supported social platforms.

YouTube Related Videos API — FAQ

YouTube Related Videos API is a programmatic interface for listing the videos YouTube recommends next to a given video, from that video's URL. It returns each recommendation's title, channel, view count and thumbnail.

It returns the whole list YouTube shows for that video, usually about 20 videos.

Yes. Shorts links, youtu.be links, live links and regular watch URLs are all accepted.

Not anymore. The official Data API stopped supporting the relatedToVideoId search parameter on August 7, 2023, so this endpoint is how you read the list YouTube shows next to a video.

The YouTube Related Videos API charges 0.5 credits for each recommended video returned, so a typical list of 20 costs 10 credits.