scraping-tiktok-posts-by-music

音楽別にTikTok投稿をスクレイピング

生データを収集します。用途は想定しておらず、後続の分析に使えるデータセット全体を返します。

---

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	✅	[]	TikTokの音楽／サウンドページのURL
maxItems	number	任意	無制限	返す投稿の最大数
customMapFunction	string	任意	—	各出力オブジェクトを変換するJavaScript関数

実行方法

run_actor.js を使用（推奨）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}' --output results.json --format json

REST API による代替方法

curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-music-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}'

Apify MCP が利用可能な場合： Apify MCP の call_actor ツールで、アクター apidojo~tiktok-music-scraper と上記の入力を指定します。

---

出力フィールド

フィールド	型	説明
id	string	TikTok投稿ID
title	string	投稿のキャプション／テキスト
views	number	視聴回数
likes	number	いいね数
comments	number	コメント数
shares	number	シェア数
hashtags	array	投稿で使用されたハッシュタグ
channel.name	string	クリエイターの表示名
channel.username	string	クリエイターの@ユーザー名
channel.verified	boolean	認証状況
uploadedAt	number	アップロード時刻（Unix）
video.url	string	動画ファイルのURL
video.duration	number	再生時間（秒）
song.id	string	サウンド／音楽のID
song.title	string	サウンドのタイトル
song.artist	string	サウンドのアーティスト
song.duration	number	サウンドの再生時間

エッジケース

• 音楽URLがない場合：TikTokのサウンドページのURLが必要です。TikTokでサウンドを見つけて、URLをコピーするようユーザーに伝えてください。
• 著作権で保護されたサウンド：地域によっては、結果が少なくなる場合があります。
• トレンドのサウンド：数千件の投稿が返される場合があります。maxItems を使って上限を設定してください。
• サウンドが削除されている場合：空のデータセットが返されます。