YouTube Related Videos Scraper — Recommendation Neighbors

Get YouTube related videos for seed watch URLs or IDs. Export adjacency-style rows (sourceVideoId → related videoId) for discovery graphs, content clustering, and expansion pipelines — metadata only, not a downloader.

Run YouTube Related Videos Scraper on Apify · Built by ScrapeMamba · Metadata only, not a downloader

---

Why this Actor?

Related rails are one of the best signals for “what YouTube thinks belongs together.” This Actor turns seed videos into neighbor lists you can warehouse, dedupe, and selectively enrich — without crawling recommendation graphs unboundedly.

• One seed → many related rows with sourceVideoId
• Cap neighbors with maxResults (default 40)
• Seed itself is excluded from results
• Fits after Search / Channel Videos in discovery workflows

---

Key features

• Related / recommendation neighbors as Dataset rows
• Clear parent link via sourceVideoId
• Per-seed caps and error isolation
• Works with watch URLs and bare IDs
• Apify Console, schedules, and API support

---

What you can scrape

Group	Fields
Graph	sourceVideoId, videoId, page
Neighbor card	title, author, channelId, thumbnail, url
Metrics	views, length, publishedTime
Diagnostics	type (related / error), raw, error

---

Use cases

• Content research — Map topical neighborhoods around a viral seed
• Competitor adjacency — See what YouTube recommends next to rival videos
• Influencer discovery — Expand from known hits into nearby creators
• Dataset building — Build edge lists for graph or clustering analysis
• Lead gen pipelines — Single-hop expansion before enrichment (keep caps low)

---

Example output

{
  "type": "related",
  "sourceVideoId": "dQw4w9WgXcQ",
  "page": 1,
  "videoId": "yPYZpwSpKmA",
  "title": "Example related video",
  "author": "Example Channel",
  "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
  "views": 980000,
  "length": 240,
  "thumbnail": "https://i.ytimg.com/vi/yPYZpwSpKmA/hqdefault.jpg",
  "url": "https://www.youtube.com/watch?v=yPYZpwSpKmA"
}

---

How to use

1. Open YouTube Related Videos Scraper
2. Paste videoIds and set maxResults
3. Run → export Dataset; dedupe videoId before re-seeding

Input example

{
  "videoIds": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "maxResults": "40"
}

API (Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapemamba/youtube-related-videos-scraper').call({
  videoIds: ['dQw4w9WgXcQ'],
  maxResults: '20',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Local run

cd youtube-related-videos-scraper-js
cp .env.example .env
npm install
node src/main.js

---

Input parameters

Parameter	Required	Default	Description
videoIds	Yes	—	Seed video URLs or 11-character IDs (deduped before fetch)
maxResults	No	"40"	Max related videos per seed. Free users capped at 200; paying users uncapped.

Fan-out warning: Re-seeding every related ID without caps grows cost quickly. Prefer low maxResults, single-hop expansion, and global dedupe.

---

Output

Successful neighbors are type: "related" with sourceVideoId pointing at the seed. Failed seeds produce type: "error".

---

Why choose this Actor

• Graph-ready rows — Parent/child IDs on every neighbor
• Controlled expansion — Caps prevent runaway crawls
• Suite-compatible — Same ID formats as Search and Video scrapers
• Clear caps — Control neighbors per seed with maxResults

---

Pricing

$0.39 per 1,000 results on Apify. Free users: maxResults capped at 200 per seed. See the Store page.

---

FAQ

How many related videos do I get per seed?

Up to your maxResults cap (default 40). Free users are capped at 200.

Suggested pipeline?

Search → pick top IDs → Related (modest maxResults) → global dedupe → Video Scraper (+ optional Subtitles).

Is the seed returned as a related row?

No. The seed videoId is filtered out.

How do I avoid cost blowups?

Low maxResults, limit recursion depth, dedupe before re-seeding.

---

Related Actors

Actor	Use it for
YouTube Search Scraper	Seed discovery
YouTube Video Scraper	Enrich neighbors
YouTube Subtitles Scraper	Caption shortlisted IDs

Use only on public recommendation data per YouTube’s terms and applicable law.