TikTok 抓取 API 指南：资料、帖子和商店数据

Ava Wilson

Expert in Web Scraping Technologies

01-Sep-2026

TL;DR:

三个角色覆盖核心工作流程。 使用 scraper.tiktok.user.detail 作为公共账户细节，scraper.tiktok.user.work 作为创作者的公共帖子，scraper.tiktok.shop.page 作为商店产品页面。
个人资料调用是连接帖子数据的桥梁。 它接受 unique_id 并返回 sec_uid，这是帖子角色所期望的。
商店请求需要产品上下文。 发送 product_id 和 region；在比较记录之前读取返回的区域和货币。
响应是结构化的 JSON。 将标识符存储为字符串，保留可为 null 的字段，并将原始响应保留在任何规范化表旁边。
TikTok 抓取 API 返回快照。 调度、历史、评分和警报应包含在调用它的管道中。
免费开始。 新的 Scrapeless 账户包含免费信用；在 Scrapeless 仪表板中创建账户。

介绍：一个端点，三个有用的 TikTok 数据集

TikTok 数据项目通常以一个简单的问题开始：工作流程可以在不维护浏览器解析器的情况下收集哪种公共账户、帖子或产品字段？答案取决于对象。创作者个人资料、创作者的帖子供稿和商店产品页面具有不同的标识符和响应形状。

Scrapeless TikTok 抓取 API 通过一个请求端点通过管理的角色暴露这些对象。API 通过 HTTP 返回 JSON，因此它适用于脚本、数据作业、内部工具和代理工作流程。本指南绘制了各个角色，发送经过身份验证的请求，并将它们的响应转换为在第一次运行后仍然可理解的记录。

有关管理角色的更广泛视图，请阅读 Scrapeless Scraper API 指南。

TikTok 抓取 API 的功能

API 接受包含 Actor 名称和 input 对象的 JSON 请求。Scrapeless 运行该 actor，并返回该 actor 的结构化结果。传输遵循 HTTP 语义规范 中描述的标准 HTTP 请求语义，而响应体使用 IANA 媒体类型注册表 中列出的注册 JSON 媒体类型。

这三个 TikTok 角色服务于不同的工作：

Actor	必要输入	主要结果
`scraper.tiktok.user.detail`	`unique_id`	公共个人资料细节和账户统计
`scraper.tiktok.user.work`	`sec_uid`	公共帖子以及媒体、音乐、标签和参与度字段
`scraper.tiktok.shop.page`	`product_id`, `region`	产品、卖家、价格、库存、选项、SKU 和运费字段

这些接口不提供关注者列表、受众人口统计、评论文本、完整的 TikTok 目录或订单分类账。将每个响应视为请求的公共对象的时间点观察。

你可以用它构建什么

创作者研究。 在人类评估品牌适合度之前，将个人资料统计与最近的帖子样本结合起来。
内容监控。 捕获选定账户的描述、帖子 URL、时间戳、标签和公共参与计数。
目录检查。 通过 ID 和区域读取已知的商店产品，包括价格、货币、库存和变体信息。
产品快照。 保存重复的产品响应及其收集时间戳，以构建历史表。
内部丰富。 将公共 TikTok 字段添加到现有的创作者或产品记录中，而无需抓取渲染的页面标记。

端点和参数

所有三个角色使用相同的端点：

POST https://api.scrapeless.com/api/v1/scraper/request

身份验证使用 x-api-token 请求标头。请求体包含 actor 和 input。

个人资料参数

scraper.tiktok.user.detail 接受 unique_id，即没有前导 @ 的用户名。其响应可以包括 account_id、unique_id、sec_uid、昵称、个人资料 URL、个人简介、头像、公共账户统计、账户创建时间、语言、国家和诸如验证、隐私和卖家状态等布尔标志。

帖子参数

scraper.tiktok.user.work 需要 sec_uid。它也接受 cursor 作为字符串和 count 作为正整数。默认 cursor 是 0，文档中列出的默认值 count 是 35。响应包含 items 数组。请勿自创续订字段：仅在响应和当前文档提供了工作流的验证续订值时推进。

商店参数

scraper.tiktok.shop.page 需要 product_id 和 region。文档中的区域示例包括 GB、SG、JP 和 US；它们是示例而不是详尽的市场列表。响应的 region 代表已解析的产品页面，并应与价格和货币一起传递。

演员的详细信息可以在 TikTok 用户详细文档、TikTok 用户工作文档和 TikTok 商店页面文档中找到。

前提条件

一个 Scrapeless 账户和来自 Scrapeless Dashboard 的 API 令牌
一个公共的 TikTok 用户名或已知的 TikTok 商店产品 ID
数据收集的允许目的和保留政策

示例需要一个有效的 Scrapeless API 令牌。在运行代码之前将其导出为 SCRAPELESS_API_KEY。

发送认证请求

此 curl 调用获取公共个人资料数据。用您的工作流被授权研究的账户替换用户名。

bash Copy

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header "x-api-token: ${SCRAPELESS_API_KEY}" \
  --header 'content-type: application/json' \
  --data '{
    "actor": "scraper.tiktok.user.detail",
    "input": {"unique_id": "tiktok"}
  }'

相同的信封适用于其他参与者。只有参与者和输入字段会改变。

使用 Scrapeless 开始抓取

通过 Scrapeless 提升您的网络抓取和自动化工作流程！
今天注册，获得 5 美元的免费积分 - 无须信用卡。

立即在 Scrapeless Dashboard 申请您的免费积分。

在 Python 中关联个人资料和帖子的数据显示

有用的连接键是 sec_uid。以下程序从个人资料响应中获取该键，然后请求一个边界帖子样本。Python 的 JSON 库文档 解释了这里使用的序列化行为。

python Copy

import json
import os
from urllib.request import Request, urlopen

ENDPOINT = "https://api.scrapeless.com/api/v1/scraper/request"
TOKEN = os.environ["SCRAPELESS_API_KEY"]


def run_actor(actor, actor_input):
    body = json.dumps({"actor": actor, "input": actor_input}).encode()
    request = Request(
        ENDPOINT,
        data=body,
        headers={
            "x-api-token": TOKEN,
            "content-type": "application/json",
        },
        method="POST",
    )
    with urlopen(request, timeout=60) as response:
        return json.load(response)


profile = run_actor(
    "scraper.tiktok.user.detail",
    {"unique_id": "tiktok"},
)

posts = run_actor(
    "scraper.tiktok.user.work",
    {"sec_uid": profile["sec_uid"], "cursor": "0", "count": 10},
)

record = {
    "profile": {
        "account_id": str(profile.get("account_id", "")),
        "unique_id": profile.get("unique_id"),
        "sec_uid": profile.get("sec_uid"),
        "nickname": profile.get("nickname"),
        "statistics": profile.get("statistics", {}),
    },
    "posts": posts.get("items", []),
}

print(json.dumps(record, ensure_ascii=False, indent=2))