scraping-tiktok-posts-by-music

按音乐抓取 TikTok 帖子

原始数据采集。不预设使用场景，返回完整数据集，供下游分析使用。

---

输入

参数	类型	必填	默认值	备注
startUrls	array	✅	[]	TikTok 音乐/声音页面 URL
maxItems	number	可选	Unlimited	最多返回的帖子数
customMapFunction	string	可选	—	用于转换每个输出对象的 JavaScript 函数

运行方法

使用 run_actor.js（推荐）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~tiktok-music-scraper" --input '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}' --output results.json --format json

REST API 备用方法

curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-music-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.tiktok.com/music/Song-Title-123456"], "maxItems": 100}'

如果可以使用 Apify MCP： 使用 Apify MCP call_actor 工具，调用 actor apidojo~tiktok-music-scraper，并传入上述输入。

---

输出字段

字段	类型	描述
id	string	TikTok 帖子 ID
title	string	帖子说明/文本
views	number	浏览量
likes	number	点赞数
comments	number	评论数
shares	number	分享数
hashtags	array	帖子中使用的话题标签
channel.name	string	创作者显示名称
channel.username	string	创作者 @用户名
channel.verified	boolean	认证状态
uploadedAt	number	上传时间戳（Unix）
video.url	string	视频文件 URL
video.duration	number	时长（秒）
song.id	string	声音/音乐 ID
song.title	string	声音标题
song.artist	string	声音艺术家
song.duration	number	声音时长

边缘情况

• 没有音乐 URL：需要 TikTok 声音页面 URL。请告知用户在 TikTok 上找到该声音并复制 URL。
• 受版权保护的声音：在某些地区可能会返回较少的结果。
• 热门声音：可能会返回数千条帖子，可使用 maxItems 限制数量。
• 声音已删除：返回空数据集。