scraping-tiktok-posts-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/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	字符串	TikTok 帖子 ID
title	字符串	帖子说明/文本
views	数字	浏览量
likes	数字	点赞数
comments	数字	评论数
shares	数字	分享数
bookmarks	数字	收藏/保存数
hashtags	数组	帖子使用的话题标签
channel.name	字符串	创作者显示名称
channel.username	字符串	创作者 @用户名
channel.verified	布尔值	认证状态
uploadedAt	数字	上传时间戳（Unix）
uploadedAtFormatted	字符串	上传时间戳（ISO 8601）
video.url	字符串	视频文件 URL
video.duration	数字	时长（秒）
song.title	字符串	音轨标题
postPage	字符串	帖子完整 URL

边缘情况

• 没有位置 URL：此 Actor 需要 TikTok 位置页面 URL，而非城市名称。请让用户前往 TikTok > 搜索该位置 > 复制 URL。
• 结果较少：某些位置带标签的帖子较少——返回现有结果。
• 私密视频：自动排除。
• 位置已删除：返回空结果。URL 可能已失效。