apidojo-io 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.40avg_engagement = (likes + comments + shares) / views→ weight 0.35verified→ 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.