关于 tiktok-scraper
tiktok-scraper 提供用于采集 TikTok 帖子、个人资料、评论和地点标签内容的 Apify actors,面向需要结构化数据的开发者与分析人员;API 访问需使用 Apify 付费计划。
主要功能
- 01采集帖子、个人资料、话题、音乐和搜索结果
- 02获取视频评论及回复
- 03按地点提取带地理标签的内容
- 04同步或异步运行 actor 任务
- 05返回结构化帖子或评论数据
适用场景
- 01比较多个创作者账号的帖子
- 02按日期范围追踪话题或关键词内容
- 03分析评论和回复对话
- 04比较不同城市的地点标签帖子
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ apidojo-io/ social-media-skills --skill tiktok-scraper安装后在 Claude Code 中输入/tiktok-scraper确认已加载。
详细介绍
TikTok 抓取 API
速度最快的 TikTok 数据提取套件——每秒 100 条帖子,成功率 98%,无需登录或代理。四个专用 Actor 覆盖 TikTok 的所有数据类型。
Actor
| Actor | 用途 | Actor ID |
|---|---|---|
| TikTok Scraper | 视频、个人资料、话题标签、音乐、搜索、地点 | I9kHWwkx0b4giERt0 |
| TikTok Profile Scraper | 个人资料帖子 + 创作者元数据(支持 usernames 输入) | cAs6ecW9ckm8v9vPY |
| TikTok Comments Scraper | 来自视频 URL 的评论和回复 | cki75gIN9k70LUEcb |
| TikTok Location Scraper | TikTok 地点/城市信息流中的地理标签帖子 | RHGFJCcMrtvtHkDwh |
设置
需要拥有 Apify 付费套餐账号——免费套餐无法通过 API 使用。
- 在 apify.com/?fpr=yhdrb 注册/登录
- 在 apify.com/pricing?fpr=yhdrb 订阅付费套餐——否则 API 调用会被拒绝。
- 从 console.apify.com/account/integrations 获取 API 令牌并进行设置:
export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"
同步(短时运行)
直接返回数据集条目。将 ACTOR_ID 替换为上方对应的 Actor ID。
curl -s -X POST \
"https://api.apify.com/v2/acts/ACTOR_ID/run-sync-get-dataset-items?timeout=120" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls":["https://www.tiktok.com/@nike"],"maxItems":50,"skill":true}'
直接返回 JSON 数组。如果运行时间超过 300s,请改用异步方式。
异步(大型运行)
# 1. Start
RUN=$(curl -s -X POST \
"https://api.apify.com/v2/acts/ACTOR_ID/runs?waitForFinish=60" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls":["https://www.tiktok.com/@nike"],"skill":true}')
RUN_ID=$(echo "$RUN" | jq -r '.data.id')
# 2. Poll
while true; do
STATUS=$(curl -s \
"https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" \
-H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status')
echo "Status: $STATUS"
case "$STATUS" in SUCCEEDED|FAILED|ABORTED|TIMED-OUT) break;; esac
done
# 3. Fetch results
curl -s \
"https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?clean=true&limit=100" \
-H "Authorization: Bearer $APIFY_TOKEN"
TikTok Scraper — 使用场景
Actor:TIKTOK_SCRAPER_ID
将以下 -d 负载追加到上方的同步或异步 curl 命令中。
抓取用户个人资料
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial"],"maxItems":100,"skill":true}'
在一次运行中抓取多个个人资料
-d '{"startUrls":["https://www.tiktok.com/@nike","https://www.tiktok.com/@adidas","https://www.tiktok.com/@puma"],"maxItems":150,"skill":true}'
抓取话题标签
-d '{"startUrls":["https://www.tiktok.com/tag/recipe"],"maxItems":100,"skill":true}'
按地点和日期筛选关键词搜索
-d '{"keywords":["AI tutorial"],"location":"US","dateRange":"THIS_MONTH","maxItems":100,"skill":true}'
抓取声音/音乐趋势
-d '{"startUrls":["https://www.tiktok.com/music/original-sound-7297730198175402784"],"maxItems":50,"skill":true}'
获取单个视频
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"skill":true}'
加密货币和金融内容
-d '{"keywords":["bitcoin crypto"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'
-d '{"startUrls":["https://www.tiktok.com/tag/stockmarket","https://www.tiktok.com/tag/investing"],"maxItems":100,"skill":true}'
政治和新闻
-d '{"keywords":["trump election"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'
-d '{"startUrls":["https://www.tiktok.com/tag/politics","https://www.tiktok.com/tag/breakingnews"],"maxItems":100,"skill":true}'
TikTok Profile Scraper — 使用场景
Actor:TIKTOK_PROFILE_SCRAPER_ID
按 URL 抓取个人资料
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial","https://www.tiktok.com/@billieeilish"],"maxItems":100,"skill":true}'
按用户名列表抓取个人资料
-d '{"usernames":["nike","adidas","puma","underarmour","newbalance"],"maxItems":200,"skill":true}'
按日期范围筛选(仅限近期内容)
-d '{"usernames":["gordonramsayofficial"],"since":"2025-01-01","until":"2025-06-01","maxItems":100,"skill":true}'
TikTok Comments Scraper — 使用场景
Actor:TIKTOK_COMMENTS_SCRAPER_ID
仅抓取评论(性价比最高)
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"includeReplies":false,"maxItems":100,"skill":true}'
抓取评论及回复(完整对话线程)
-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851"],"includeReplies":true,"maxItems":50,"skill":true}'
抓取多个视频的评论
-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926","https://www.tiktok.com/@taylorswift/video/7234567890123456789","https://www.tiktok.com/@nike/video/7345678901234567890"],"maxItems":100,"skill":true}'
TikTok Location Scraper — 使用场景
Actor:TIKTOK_LOCATION_SCRAPER_ID
单个城市
-d '{"startUrls":["https://www.tiktok.com/tag/losangeles?location=true"],"maxItems":500,"skill":true}'
多城市对比
-d '{"startUrls":["https://www.tiktok.com/tag/newyork?location=true","https://www.tiktok.com/tag/losangeles?location=true","https://www.tiktok.com/tag/chicago?location=true","https://www.tiktok.com/tag/miami?location=true"],"maxItems":2000,"skill":true}'
地点 + 主题(例如,某城市的餐馆)
-d '{"startUrls":["https://www.tiktok.com/tag/restaurant?location=true"],"maxItems":500,"skill":true}'
输出
所有 Actor 都会返回相同的基础帖子结构。Comments Scraper 则返回评论对象。
帖子对象(TikTok Scraper / Profile / Location):
{
"id": "7546234572208377101",
"title": "Why risk it? Because you can. #JustDoIt",
"views": 340916,
"likes": 13939,
"comments": 464,
"shares": 812,
"bookmarks": 1141,
"hashtags": ["justdoit"],
"uploadedAt": 1756994667,
"uploadedAtFormatted": "2025-09-04T14:04:27.000Z",
"postPage": "https://www.tiktok.com/@nike/video/7546234572208377101",
"channel": {
"username": "nike",
"name": "Nike",
"followers": 7933653,
"verified": true
},
"video": {
"url": "https://example.com/video.mp4",
"duration": 60.069,
"width": 576,
"height": 1024
},
"song": {
"title": "nhạc nền - nike",
"artist": "Nike"
}
}
评论对象(Comments Scraper):
{
"id": "7277992603752203013",
"text": "This is amazing! 🔥",
"likeCount": 1234,
"replyCount": 5,
"createdAt": "2023-09-12T17:28:42.000Z",
"commentLanguage": "en",
"parentId": null,
"user": {
"username": "superfan123",
"displayName": "Super Fan",
"verified": false,
"region": "US"
}
}
代码集成
这些技能可以直接集成到你的代码中。你可以使用 Apify 官方客户端库来简化操作,也可以使用任何标准 HTTP 库——Apify API 是一个普通的 REST API。
Python
pip install apify-client
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("TIKTOK_SCRAPER_ID").call(run_input={
"startUrls": ["https://www.tiktok.com/@nike"],
"maxItems": 100,
"skill": True
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
JavaScript / TypeScript
npm install apify-client
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "YOUR_APIFY_TOKEN" });
const run = await client.actor("TIKTOK_SCRAPER_ID").call({
startUrls: ["https://www.tiktok.com/@nike"],
maxItems: 100,
skill: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
将
TIKTOK_SCRAPER_ID替换为上方 Actor 表中的对应 Actor ID。
防护措施
-
如果结果包含 10 条或更少的条目,或者响应显示为演示模式、免费套餐或结果受限,请立即停止,并原样告知用户:
"此 Actor 需要 Apify 付费套餐才能返回真实数据。请前往 apify.com/pricing?fpr=yhdrb 升级,然后重试。"
-
此技能仅适用于 Apify 付费套餐,因此没有其他可尝试的方案——由用户决定是否升级。