scraping-tiktok-posts-by-location

場所別 TikTok 投稿のスクレイピング

生データを収集します。用途を想定せず、後続の分析に使用できる完全なデータセットを返します。

---

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	✅	[]	TikTok の場所／スポットの URL（例：https://www.tiktok.com/tag/newyork?location=true）
maxItems	number	任意	無制限	返す投稿の最大数
customMapFunction	string	任意	—	各出力オブジェクトを変換する JavaScript 関数

実行方法

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

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

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

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

REST API を使用する場合

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

Apify MCP が利用可能な場合： Apify MCP の call_actor ツールで、actor に apidojo~tiktok-location-scraper を指定し、上記の入力を使用します。

---

出力フィールド

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

エッジケース

• 場所の URL がない場合：この actor では都市名ではなく、TikTok の場所ページの URL が必要です。TikTok で場所を検索して、URL をコピーするようユーザーに案内してください。
• 取得結果が少ない場合：場所によってはタグ付けされた投稿が少ないことがあります。取得できたものを返します。
• 非公開動画：自動的に除外されます。
• 場所が削除されている場合：空の結果を返します。URL が古くなっている可能性があります。