Finding Tiktok Creators By Location

---

Inputs

Parameter	Type	Required	Default	Notes
startUrls	array	✅	[]	TikTok location/place URLs (e.g. https://www.tiktok.com/tag/newyork?location=true)
maxItems	number	Optional	Unlimited	Maximum posts 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~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 fallback

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

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

---

Scoring & Ranking

Score each creator by:

• followers → normalized 0-1 (cap at 500K), weight 0.40
• avg_engagement = (likes + comments + shares) / views → weight 0.35
• verified → 0 or 1, weight 0.25

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

---

Classification

Score	Tier	Label
≥ 0.70	A	PRIME_CREATOR
0.40–0.69	B	GOOD_FIT
< 0.40	C	LOW_PRIORITY

---

Edge Cases

• No TikTok location URL: Must provide a TikTok location page URL — not a city name. Tell user to find it via TikTok search.
• Few results: Some locations have limited geotagged content. Return what's available.
• Duplicate creators: Same creator may post multiple videos from the location — deduplicate by channel.username.
• Irrelevant content: Location posts may include tourists, not locals. Cross-check bio for location signals.
• Stale content: Sort by most recent if freshness is important.