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
| Parameters | Required | Description |
|---|---|---|
url | Required | A 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.
- POST {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} to /v1/youtube/related-videos.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- 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