YouTube Related Videos: the watch-next list for any video

The related videos YouTube shows next to a video, up to 100 videos per run: one row per suggestion with rank, title, channel, views, length and thumbnail, as an anonymous viewer in a chosen country sees them. Pay per related video.

Why this scraper

• Only delivered results are charged. Inputs that fail come back as clear error records at no cost.
• One light request per page of suggestions over YouTube's mobile route, no browser: the same list YouTube renders next to the video, read as data. Measured on two videos: 30 suggestions each, with title, channel, views, length and thumbnail, for less than a tenth of a cent per video.
• The list is what an anonymous viewer in the chosen country gets, so it is YouTube's generic association for that video, not a personal feed. Each row carries the channel id, so the suggestions can be grouped by channel; the source video is never repeated in its own list.

Who this is for

Paste video URLs, youtu.be links or 11-character ids in videos (up to 100 per run), set maxRelatedPerVideo (default 20, ceiling 100) and optionally the country of the anonymous viewer. Every row carries the source video id, the rank, the suggested video's id, URL, title, channel name, channel id and URL, view count, length in seconds and thumbnail.

Who this is not for

Suggestions are YouTube's and change between runs and countries; two runs an hour apart overlap heavily but are not identical. They are computed for an anonymous viewer, so they never reflect a specific account's history. View counts are YouTube's rounded figures (1.6M becomes 1600000); a live stream in the list has no view count. A video YouTube cannot show (private, deleted) comes back as one free NO_RELATED error row.

Input example

{
    "videos": [
        "https://www.youtube.com/watch?v=ifI_fwg55k8"
    ],
    "maxRelatedPerVideo": 20,
    "country": "US"
}

Output example

• sourceVideoId
• position
• videoId
• url
• title
• channelName
• channelId
• channelUrl
• viewCount
• durationSeconds
• thumbnailUrl

Error codes: INVALID_VIDEO_ID, VIDEO_UNAVAILABLE, NO_RELATED, BLOCKED.

One delivered row looks like this:

{
  "sourceVideoId": "ifI_fwg55k8",
  "position": 1,
  "videoId": "tEmLMCPK8OE",
  "url": "https://www.youtube.com/watch?v=tEmLMCPK8OE",
  "title": "Retro Tech: Teleportation",
  "channelName": "Marques Brownlee",
  "channelId": "UCBJycsmduvYEL83R_U4JriQ",
  "channelUrl": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ",
  "viewCount": 1600000,
  "durationSeconds": 1212,
  "thumbnailUrl": "https://i.ytimg.com/vi/tEmLMCPK8OE/hq720.jpg?sqp=-oaymwEhCK4FEIIDSFryq4qpAxMIARUAAAAAGAElAADIQj0AgKJD&rs=AOn4CLA3QaiwGm7fdmIm9d8v5m-qGKV_Ow",
  "status": "ok"
}

Related actors from steadydata

• youtube-video-details: full metadata of any of the related videos
• youtube-search: search results for a keyword instead of a video
• youtube-transcript-bulk: transcripts of the related videos

Pricing

Pay per event: one related-video-listed event per delivered result. No charge for inputs that fail, no separate platform-usage surcharge.

Free Apify plan: this actor delivers up to 25 rows per run for accounts on the Apify free plan, and then stops with a message. That limit is set by us, not by Apify. It exists so the actor keeps paying for itself for the people who do pay. Any paid Apify plan runs it at full size, billed per delivered row, with failed rows never charged.

Reviews: if this actor saves you time, a short review on this page is the one thing that helps most. Ratings are what other buyers look at first, and we have no other way to ask.

FAQ

Is this the same list as on youtube.com? It is the list YouTube serves to a signed-out viewer in that country, in order; the website may add ads and personalised items on top.

How deep can I go? Up to 100 suggestions per video, paged like the website's endless list; maxRelatedPerVideo caps the cost.

Do I pay for a video without suggestions? No. Only delivered suggestion rows are charged.

Can I get the full details of the suggested videos? Pass the videoId column to the YouTube Video Details actor from the related actors below.

Why does the channel id miss on a few rows? Some cards (typically ads or mixes) carry no channel link; the name is still there.

Is personal data collected? position is YouTube's order on the watch page, top to bottom.

What happens when the source changes? Sources change from time to time; that is the nature of this work. The actor is monitored daily and fixed fast, and while it is broken you are not charged, because only delivered results cost anything.