Scraping Youtube Channel Info

Raw data collection. No assumed use case — returns the full dataset for downstream analysis.

---

Inputs

Parameter	Type	Required	Default	Notes
startUrls	array	Optional	[]	YouTube channel URLs
youtubeHandles	array	Optional	[]	YouTube handles (e.g. @kurzgesagt)
keywords	array	Optional	[]	Search keywords to find channels
gl	string	Optional	us	Country code (e.g. US)
hl	string	Optional	en	Language code (e.g. en)
sort	string	Optional	r	Sort order
maxItems	number	Optional	Unlimited	Maximum channels to return
customMapFunction	string	Optional	—	JavaScript function to transform each output object

How to Run

Using run_actor.js (recommended)

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.json --format json

REST API fallback

curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-channel-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

If Apify MCP is available: Use the Apify MCP call_actor tool with actor apidojo~youtube-channel-scraper and the input above.

---

Output Fields

Field	Type	Description
id	string	YouTube channel ID
name	string	Channel name
url	string	Channel URL
description	string	Channel description
subscriberCount	number	Subscriber count
videosCount	number	Total videos published
thumbnails	array	Channel thumbnails
isVerified	boolean	Verification badge
isFamilySafe	boolean	Family-safe flag
keywords	array	Channel keywords
availableCountries	array	Countries where available
tags	array	Channel tags

Edge Cases

• Channel not found: Check if handle is correct or try with URL instead.
• subscriberCount as text: Field returns '1.2M subscribers' not a number — parse downstream if needed.
• No keywords in metadata: Some channels don't set keywords — tags array will be empty.
• Private/terminated channel: Returns no results for that channel.