scraping-youtube-channel-info

YouTube チャンネル情報のスクレイピング

生データを収集します。想定されるユースケースはありません。後続の分析用に、データセット全体を返します。

---

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	任意	[]	YouTube チャンネルの URL
youtubeHandles	array	任意	[]	YouTube ハンドル（例：@kurzgesagt）
keywords	array	任意	[]	チャンネル検索に使用するキーワード
gl	string	任意	us	国コード（例：US）
hl	string	任意	en	言語コード（例：en）
sort	string	任意	r	並べ替え順
maxItems	number	任意	無制限	返すチャンネルの最大数
customMapFunction	string	任意	—	各出力オブジェクトを変換する JavaScript 関数

実行方法

run_actor.js を使用する（推奨）

# 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 を使用する場合

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}'

Apify MCP を利用できる場合： Apify MCP の call_actor ツールで、actor apidojo~youtube-channel-scraper と上記の入力を使用します。

---

出力フィールド

フィールド	型	説明
id	string	YouTube チャンネル ID
name	string	チャンネル名
url	string	チャンネル URL
description	string	チャンネルの説明
subscriberCount	number	チャンネル登録者数
videosCount	number	公開済み動画の合計数
thumbnails	array	チャンネルのサムネイル
isVerified	boolean	認証バッジ
isFamilySafe	boolean	ファミリー向けフラグ
keywords	array	チャンネルのキーワード
availableCountries	array	利用可能な国
tags	array	チャンネルのタグ

エッジケース

• チャンネルが見つからない場合：ハンドルが正しいか確認するか、代わりに URL を試してください。
• subscriberCount がテキストの場合：フィールドは数値ではなく「登録者 120 万人」のような値を返します。必要に応じて後続処理で解析してください。
• メタデータにキーワードがない場合：キーワードを設定していないチャンネルもあります。その場合、tags 配列は空になります。
• 非公開／停止済みのチャンネル：そのチャンネルの結果は返されません。