finding-tiktok-creators-by-location

場所からTikTokクリエイターを探す

---

入力

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

実行方法

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

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

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/Miami-Florida-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/Miami-Florida-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/Miami-Florida-123456"], "maxItems": 100}'

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

---

スコアリングとランキング

各クリエイターを次の基準で採点します：

• followers → 0〜1に正規化（上限は500K）、重み0.40
• avg_engagement = (likes + comments + shares) / views → 重み0.35
• verified → 0または1、重み0.25

score = 0.40 * min(followers / 500000, 1.0) + 0.35 * min(avg_engagement / 0.08, 1.0) + 0.25 * int(verified)

---

分類

スコア	ランク	ラベル
≥ 0.70	A	PRIME_CREATOR
0.40–0.69	B	GOOD_FIT
< 0.40	C	LOW_PRIORITY

---

エッジケース

• TikTokの場所URLがない場合：都市名ではなく、TikTokの場所ページのURLを指定する必要があります。TikTok検索で見つけるようユーザーに案内してください。
• 結果が少ない場合：場所によっては、位置情報が付いたコンテンツが限られています。取得できた結果を返してください。
• クリエイターの重複：同じクリエイターがその場所から複数の動画を投稿している場合があります。channel.usernameを基準に重複を除外してください。
• 関連性の低いコンテンツ：その場所の投稿には、地元の人ではなく観光客の投稿が含まれる場合があります。プロフィールの自己紹介に場所を示す情報があるか確認してください。
• 古いコンテンツ：新しさが重要な場合は、最新の投稿順に並べ替えてください。