scraping-tiktok-posts-by-music

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scraping Tiktok Posts By Music

按音乐抓取TikTok帖子

Raw data collection. No assumed use case — returns the full dataset for downstream analysis.

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

Inputs

输入参数

Parameter	Type	Required	Default	Notes
`startUrls`	array	✅	`[]`	TikTok music/sound page URLs
`maxItems`	number	Optional	Unlimited	Maximum posts to return
`customMapFunction`	string	Optional	—	JavaScript function to transform each output object

参数	类型	必填	默认值	说明
`startUrls`	array	✅	`[]`	TikTok音乐/音效页面URL
`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-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

undefined

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

undefined

REST API fallback

备用REST API

bash

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}'

If Apify MCP is available: Use the Apify MCP

call_actor

tool with actor

apidojo~tiktok-music-scraper

and the input above.

bash

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

并传入上述输入参数。

Output Fields

输出字段

Field	Type	Description
`id`	string	TikTok post ID
`title`	string	Post caption/text
`views`	number	View count
`likes`	number	Like count
`comments`	number	Comment count
`shares`	number	Share count
`hashtags`	array	Hashtags used in post
`channel.name`	string	Creator display name
`channel.username`	string	Creator @username
`channel.verified`	boolean	Verification status
`uploadedAt`	number	Upload timestamp (Unix)
`video.url`	string	Video file URL
`video.duration`	number	Duration in seconds
`song.id`	string	Sound/music ID
`song.title`	string	Sound title
`song.artist`	string	Sound artist
`song.duration`	number	Sound duration

字段	类型	描述
`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	音效时长（秒）

Edge Cases

边缘情况

No music URL: Requires TikTok sound page URL. Tell user to find the sound on TikTok and copy the URL.
Copyrighted sound: May have fewer results in some regions.
Trending sound: May return thousands of posts — use maxItems to cap.
Sound removed: Returns empty dataset.

无音乐URL：需要提供TikTok音效页面URL。告知用户在TikTok上找到该音效并复制其URL。
受版权保护的音效：在部分地区可能返回较少结果。
热门音效：可能返回数千条帖子——使用maxItems参数限制数量。
音效已移除：返回空数据集。