Scraping TikTok Posts By Location
用途
该技能用于按地点抓取 TikTok 帖子。它调用 Apify 平台上的 apidojo TikTok Location Scraper，采集特定位置下被标记的帖子，定位为原始数据采集，不预设具体使用场景，返回完整数据集供下游分析。
当用户需要获取某个 TikTok 位置的视频时触发。
主要能力
- 按 TikTok 地点/位置页面 URL 收集帖子。
- 可限制返回的最大帖子数量（maxItems，默认不限）。
- 支持通过 customMapFunction 传入 JavaScript 函数，对每个输出对象做转换。
- 输出包含帖子 ID、标题、观看量、点赞数、评论数、分享数、收藏数、标签、创作者名称与用户名、认证状态、上传时间戳（Unix 与 ISO 8601 格式）、视频文件 URL、视频时长、音频标题以及帖子完整链接。
使用方式
使用 run_actor.js（推荐）
快速以表格形式查看结果：
node scripts/run_actor.js --actor "apidojo~tiktok-location-scraper" --input '{"startUrls": ["https://www.tiktok.com/place/New-York-City-123456"], "maxItems": 100}'
保存为 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
保存为 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，并传入上述输入。
输入参数
- startUrls（数组，必填，默认 []）：TikTok 地点/位置 URL，例如 https://www.tiktok.com/tag/newyork?location=true。
- maxItems（数字，可选，默认不限）：返回的最大帖子数。
- customMapFunction（字符串，可选）：用于转换每个输出对象的 JavaScript 函数。
输出字段
- id：帖子 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（字符串）
适用场景
适合需要按地理位置收集 TikTok 帖子原始数据、再进行后续分析的任务。
限制与边界情况
- 必须提供 TikTok 地点页面 URL，不能仅用城市名；需引导用户前往 TikTok，搜索地点并复制 URL。
- 部分地点被标记的帖子较少，只能返回现有结果。
- 私密视频会被自动排除。
- 地点已删除时返回空结果，URL 可能已失效。