finding-tiktok-creators-by-location

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Finding Tiktok Creators By Location

按地理位置查找TikTok创作者

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

参数	类型	是否必填	默认值	说明
`startUrls`	array	✅	`[]`	TikTok地点/位置URL（例如 `https://www.tiktok.com/tag/newyork?location=true` ）
`maxItems`	number	可选	无限制	返回的最大帖子数量
`customMapFunction`	string	可选	—	用于转换每个输出对象的JavaScript函数

How to Run

运行方式

Using run_actor.js (recommended)

使用run_actor.js（推荐）

bash

undefined

bash

undefined

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

undefined

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

undefined

REST API fallback

备用REST API方式

bash

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.

bash

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

工具，指定actor为

apidojo~tiktok-location-scraper

并传入上述输入参数。

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

python

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

按以下维度为每位创作者评分：

```
followers
```
→ 归一化至0-1（上限为50万），权重0.40

avg_engagement = (likes + comments + shares) / views

→ 权重0.35

```
verified
```
→ 0或1，权重0.25

python

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

分数	等级	标签
≥ 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.

无TikTok位置URL：必须提供TikTok地点页面URL，而非城市名称。告知用户通过TikTok搜索获取该URL。
结果数量少：部分地点的地理标记内容有限，返回现有可用结果即可。
重复创作者：同一创作者可能从同一地点发布多条视频，需通过channel.username去重。
无关内容：地点相关帖子可能包含游客内容，而非本地创作者，需交叉检查简介中的位置信息。
内容过时：若注重时效性，需按最新发布时间排序。