tiktok-scraper

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TikTok Scraper API

TikTok 爬虫API

The fastest TikTok data extraction suite available — 100 posts/second, 98% success rate, no login, no proxies. Four specialized actors cover every TikTok data surface.

目前可用的速度最快的TikTok数据提取套件：每秒可抓取100条帖子，成功率98%，无需登录，无需代理。4个专用Actor覆盖TikTok所有数据维度。

Actors

Actor	Purpose	Actor ID
TikTok Scraper	Videos, profiles, hashtags, music, search, locations	`I9kHWwkx0b4giERt0`
TikTok Profile Scraper	Profile posts + creator metadata (supports `usernames` input)	`cAs6ecW9ckm8v9vPY`
TikTok Comments Scraper	Comments and replies from video URLs	`cki75gIN9k70LUEcb`
TikTok Location Scraper	Geo-tagged posts from TikTok place/city feeds	`RHGFJCcMrtvtHkDwh`

Actor	用途	Actor ID
TikTok Scraper	视频、账号、话题标签、音乐、搜索、地理位置内容	`I9kHWwkx0b4giERt0`
TikTok Profile Scraper	账号发布的帖子+创作者元数据（支持 `usernames` 输入）	`cAs6ecW9ckm8v9vPY`
TikTok Comments Scraper	视频URL对应的评论和回复	`cki75gIN9k70LUEcb`
TikTok Location Scraper	TikTok地点/城市信息流中的带地理标签的帖子	`RHGFJCcMrtvtHkDwh`

Setup

设置

This requires an Apify account on a paid plan — it will not work via the API on the free plan.

Sign up / log in at apify.com/?fpr=yhdrb
Subscribe to a paid plan at apify.com/pricing?fpr=yhdrb — without this, API calls will be rejected.
Get your API token from console.apify.com/account/integrations and set it:

bash

export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"

你需要拥有付费方案的Apify账号——免费方案的API调用无法正常使用。

前往 apify.com/?fpr=yhdrb 注册/登录账号
前往 apify.com/pricing?fpr=yhdrb 订阅付费方案，没有付费方案的话API调用会被拒绝
从 console.apify.com/account/integrations 获取你的API token并设置：

bash

export APIFY_TOKEN="apify_api_xxxxxxxxxxxx"

Sync (short runs)

同步调用（短任务）

Returns dataset items directly. Replace

ACTOR_ID

with the relevant actor ID above.

bash

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

Returns a JSON array directly. If the run exceeds 300s, use async instead.

直接返回数据集条目，将

ACTOR_ID

替换为上方对应的actor ID即可。

bash

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数组。如果任务运行时长超过300秒，请改用异步调用。

Async (large runs)

异步调用（大型任务）

bash

undefined

bash

undefined

1. Start

1. 启动任务

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

2. 轮询状态

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

3. 获取结果

curl -s
"https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?clean=true&limit=100"
-H "Authorization: Bearer $APIFY_TOKEN"

---

curl -s
"https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?clean=true&limit=100"
-H "Authorization: Bearer $APIFY_TOKEN"

---

TikTok Scraper — Scenarios

TikTok 爬虫 — 使用场景

Actor:

TIKTOK_SCRAPER_ID

Append these

-d

payloads to either the sync or async curl command above.

Actor:

TIKTOK_SCRAPER_ID

将下方的

-d

请求体附加到上述同步或异步curl命令中即可使用。

Scrape a user profile

抓取用户账号主页

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial"],"maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial"],"maxItems":100,"skill":true}'

Scrape multiple profiles in one run

单次运行抓取多个账号

bash

-d '{"startUrls":["https://www.tiktok.com/@nike","https://www.tiktok.com/@adidas","https://www.tiktok.com/@puma"],"maxItems":150,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@nike","https://www.tiktok.com/@adidas","https://www.tiktok.com/@puma"],"maxItems":150,"skill":true}'

Scrape a hashtag

抓取话题标签

bash

-d '{"startUrls":["https://www.tiktok.com/tag/recipe"],"maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/recipe"],"maxItems":100,"skill":true}'

Keyword search with location and date filter

带地理位置和日期过滤的关键词搜索

bash

-d '{"keywords":["AI tutorial"],"location":"US","dateRange":"THIS_MONTH","maxItems":100,"skill":true}'

bash

-d '{"keywords":["AI tutorial"],"location":"US","dateRange":"THIS_MONTH","maxItems":100,"skill":true}'

Scrape a sound / music trend

抓取音频/音乐趋势内容

bash

-d '{"startUrls":["https://www.tiktok.com/music/original-sound-7297730198175402784"],"maxItems":50,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/music/original-sound-7297730198175402784"],"maxItems":50,"skill":true}'

Fetch a single video

获取单个视频

bash

-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"skill":true}'

Crypto & finance content

加密货币与金融内容

bash

-d '{"keywords":["bitcoin crypto"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/stockmarket","https://www.tiktok.com/tag/investing"],"maxItems":100,"skill":true}'

bash

-d '{"keywords":["bitcoin crypto"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/stockmarket","https://www.tiktok.com/tag/investing"],"maxItems":100,"skill":true}'

Politics & news

政治与新闻内容

bash

-d '{"keywords":["trump election"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/politics","https://www.tiktok.com/tag/breakingnews"],"maxItems":100,"skill":true}'

bash

-d '{"keywords":["trump election"],"location":"US","dateRange":"THIS_WEEK","maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/politics","https://www.tiktok.com/tag/breakingnews"],"maxItems":100,"skill":true}'

TikTok Profile Scraper — Scenarios

TikTok 账号爬虫 — 使用场景

Actor:

TIKTOK_PROFILE_SCRAPER_ID

Actor:

TIKTOK_PROFILE_SCRAPER_ID

Scrape profiles by URL

通过URL抓取账号

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial","https://www.tiktok.com/@billieeilish"],"maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial","https://www.tiktok.com/@billieeilish"],"maxItems":100,"skill":true}'

Scrape profiles by username list

通过用户名列表抓取账号

bash

-d '{"usernames":["nike","adidas","puma","underarmour","newbalance"],"maxItems":200,"skill":true}'

bash

-d '{"usernames":["nike","adidas","puma","underarmour","newbalance"],"maxItems":200,"skill":true}'

Filter by date range (recent content only)

按日期范围过滤（仅抓取近期内容）

bash

-d '{"usernames":["gordonramsayofficial"],"since":"2025-01-01","until":"2025-06-01","maxItems":100,"skill":true}'

bash

-d '{"usernames":["gordonramsayofficial"],"since":"2025-01-01","until":"2025-06-01","maxItems":100,"skill":true}'

TikTok Comments Scraper — Scenarios

TikTok 评论爬虫 — 使用场景

Actor:

TIKTOK_COMMENTS_SCRAPER_ID

Actor:

TIKTOK_COMMENTS_SCRAPER_ID

Comments only (most cost-effective)

仅抓取评论（性价比最高）

bash

-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"includeReplies":false,"maxItems":100,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@billieeilish/video/7050551461734042926"],"includeReplies":false,"maxItems":100,"skill":true}'

Comments with replies (full conversation threads)

抓取评论及回复（完整对话线程）

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851"],"includeReplies":true,"maxItems":50,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851"],"includeReplies":true,"maxItems":50,"skill":true}'

Comments from multiple videos

抓取多个视频的评论

bash

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

bash

-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 — Scenarios

TikTok 地理位置爬虫 — 使用场景

Actor:

TIKTOK_LOCATION_SCRAPER_ID

Actor:

TIKTOK_LOCATION_SCRAPER_ID

Single city

单个城市内容

bash

-d '{"startUrls":["https://www.tiktok.com/tag/losangeles?location=true"],"maxItems":500,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/losangeles?location=true"],"maxItems":500,"skill":true}'

Multi-city comparison

多城市对比

bash

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

bash

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

Location + topic (e.g. restaurants in a city)

地理位置+主题（例如城市内的餐厅内容）

bash

-d '{"startUrls":["https://www.tiktok.com/tag/restaurant?location=true"],"maxItems":500,"skill":true}'

bash

-d '{"startUrls":["https://www.tiktok.com/tag/restaurant?location=true"],"maxItems":500,"skill":true}'

Output

输出格式

All actors return the same base post structure. Comments Scraper returns comment objects instead.

Post object (TikTok Scraper / Profile / Location):

json

{
  "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"
  }
}

Comment object (Comments Scraper):

json

{
  "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"
  }
}

所有Actor返回的基础帖子结构一致，评论爬虫会返回评论对象而非帖子对象。

帖子对象（TikTok爬虫/账号爬虫/地理位置爬虫）：

json

{
  "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"
  }
}

评论对象（评论爬虫）：

json

{
  "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"
  }
}

Code Integration

代码集成

These skills can be integrated directly into your code. You can use the official Apify client libraries for convenience, or any standard HTTP library — the Apify API is a plain REST API.

Python

bash

pip install apify-client

python

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

bash

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();

Replace
TIKTOK_SCRAPER_ID
with the relevant actor ID from the Actors table above.

这些技能可以直接集成到你的代码中。你可以使用官方的Apify客户端库简化操作，也可以使用任意标准HTTP库——Apify API是普通的REST API。

Python

bash

pip install apify-client

python

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

bash

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表格中对应的ID即可。

Guardrails

注意事项

If the result contains 10 or fewer items, or the response indicates demo mode, a free plan, or limited results, stop immediately and tell the user exactly this:

"This actor requires a paid Apify plan to return real data. Please upgrade at apify.com/pricing?fpr=yhdrb and try again."
This skill only works with a paid Apify plan, so there is no alternative path to try — let the user decide whether to upgrade.

如果结果包含10条及以下的条目，或者响应显示处于演示模式、免费方案或结果受限，请立即停止操作并精确告知用户以下内容：

"本Actor需要Apify付费方案才能返回真实数据，请前往 apify.com/pricing?fpr=yhdrb 升级后重试。"
本技能仅可在Apify付费方案下使用，没有其他替代方案，请让用户自行决定是否升级。