TikTok 公开数据 API:资料、视频、广告和店铺

用一套 REST API 读取 TikTok 公开资料、视频、评论、Creative Center 趋势和店铺商品数据。无需 SDK,一把 SandBase Key,为 Agent 而建。

深色电影感渲染:TikTok 公开数据(资料、视频、广告、店铺信号)流经一条 API 导管汇入 agent 核心

把 TikTok 的公开数据接进 Agent,往往先要经历一场”找字段”的游戏:哪个移动端端点才返回粉丝数、为什么这里叫 secUid 那里又叫 uniqueId、web 和 app 两套接口的分页游标还不一样。数据在 App 里明明是公开的,可要稳定地接进工作流,本身就成了一个独立的小工程。

SandBase 的 TikTok 公开数据 API 就是来省掉这段的。它通过一组普通 REST 端点,读取 TikTok 的公开资料、视频、评论、搜索、Creative Center 趋势信号和店铺商品数据——一把 SandBase Key、同步返回 JSON、不用装 SDK。端点参考只保证信封(id、status、model 和 outputs[0].data);下面展示的业务字段来自 2026-10-01(UTC)的一次真实调用,仅为实测观察、并非保证的 schema,请以你自己的响应为准核对具体字段。

这不是 TikTok 官方的开发者平台。 登录、内容发布用 TikTok for Developers(Login Kit 和 Content Posting API);管理已授权的广告账户用 TikTok API for Business。而如果你的工作流需要的是公开、只读的发现、监控或研究数据,就用 SandBase。想上手的话:获取 SandBase API Key、浏览 TikTok 端点。

先说结论

  • 一套 API 读取 TikTok 的公开资料、视频、评论、搜索、直播信号、Creative Center 趋势和店铺商品数据。
  • 本文用到的 Model API 端点以 POST /v1/api/tiktok/<path> 调用——body 里只传该端点的参数,无 SDK,一把 SANDBASE_API_KEY。
  • 端点分布在 web、app-v3、ads、shop-web 等 surface 上;不同 surface 的参数名、分页和响应结构会不一样,以每个端点的 schema 为准。
  • 只返回公开、只读数据;不能发帖、不走 TikTok OAuth 登录、也无法访问私密账号;用一把 SandBase API Key 鉴权。

你需要哪种 TikTok API?

你的需求选谁原因
登录、内容发布、或授权创作者操作TikTok for Developers官方 Login Kit 和 Content Posting API。
创建、管理或统计已授权的广告账户TikTok API for Business官方 Marketing API,用于广告投放管理。
读取公开的资料、视频、Creative Center 趋势或店铺商品数据SandBase TikTok 公开数据接口普通 REST、一把 SandBase Key、只读发现与监控的结构化 JSON。
访问私密账号、私信、或需登录才能看的数据都不适用这类数据不在本篇公开数据指南的范围内。

TikTok API 能拿到什么

目录按 surface 组织,和 TikTok 自身暴露数据的方式一致。按用途分几类:

  • 资料与用户——公开用户资料与统计、粉丝与关注列表、转发、相似账号推荐、按用户名查账号所属国家。
  • 视频与内容——某用户的帖子、单条视频详情、话题视频列表、视频搜索,以及从链接提取视频/aweme ID。
  • 评论——视频评论与评论回复。
  • 直播——直播间信息与礼物列表、直播搜索、直播排行榜。
  • Creative Center 趋势——热门话题、热门广告案例等公开趋势与创意研究信号。
  • 店铺商品数据——公开商品详情与评价、分类列表、卖家商品列表、按分享链接解析店铺。

截至 2026-10-01,SandBase TikTok 目录在这些 surface 上列出 145 个端点。动手前请以每个端点的线上 API 参考为准。

依赖登录态与暂不可调用的端点

以下端点不在本篇公开数据工作流范围内(本篇只用一把 SandBase Key、无需 TikTok 登录):

  • 创作者账号分析(依赖登录态)。 tiktok/creator/* 这组端点(如 tiktok/creator/account-health-status、tiktok/creator/creator-account-info)统计的是已登录创作者自己的账号。account-health-status 参考列有 cookie 字段(“User Cookie string for authentication”)。2026-10-01 不带 cookie 调用时,请求虽然 completed,但 data 里返回的是登录错误:"You must log in to continue" 和 "user not login"。
  • 暂不可直接调用。 2026-10-01 调用 tiktok/bulk/video-metadata、tiktok/bulk/comments、tiktok/shop-web/product-reviews、tiktok/shop-web/hot-selling-products-list 和 tiktok/web/user-collect(它还要求用户 cookie),均返回 HTTP 404 endpoint_not_found。评价数据可以看目录里的 tiktok/shop-web/product-reviews-v2。

SandBase TikTok API 目录页,显示 145 个端点,选中的端点卡片标为 Available、Free(API Free Week 期间) 截图:SandBase TikTok 目录页显示“145 SHOWN”,每个端点都带路径和说明,选中的 app-v3/creator-search-insights 卡片标为 Available 和 Free(2026-10-02 截取)。Free 是 API Free Week 期间的标价,活动已结束;数据 API 现在每个组织每天在符合条件的 API 上有 100 次免费调用,超出后按次计费。

TikTok 提供什么,SandBase 补什么

公开数据本身来自 TikTok,SandBase 既不拥有也不运营 TikTok,它做的是为合规的公开数据场景提供一层统一的 API 接入:每个能力对应一个固定的端点、鉴权收敛成一把 Key、响应结构也稳定可预期。这样一来,“先按用户名查到账号 → 读资料统计 → 拉近期视频 → 读评论”这样一条链路,Agent 就能顺着一套约定走完,不用为每个 surface 各配一套鉴权和解析。

快速上手:第一次调用

SandBase 有不止一套 API surface。目录里可能展示 /apis/v1/... 的 GET 路径;本文用的是每个端点 API 参考页上标注的 vendor-qualified Model API 路径。别把 HTTP 方法或 URL 混用——以你要调的那个端点的参考为准。

本文的每个能力都以 POST /v1/api/tiktok/<path> 调用。SandBase 没有专属 SDK,这些都是普通 HTTP 调用。下面的示例只调一个端点,schema 见 tiktok/web/user-profile API 参考。按用户名读公开资料(注意驼峰写法的 uniqueId——TikTok 的参数名跟随上游 API,所以每个端点都要看它自己的 schema):

Python
import os
import requests

resp = requests.post(
    "https://api.sandbase.ai/v1/api/tiktok/web/user-profile",
    headers={
        "Authorization": f"Bearer {os.environ['SANDBASE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"uniqueId": "tiktok"},  # 用户名,不带 @
)
resp.raise_for_status()
body = resp.json()
outputs = body.get("outputs") or []
if body.get("status") != "completed" or not outputs:
    raise RuntimeError(f"SandBase call did not complete: {body.get('status')} {body.get('error')}")
data = outputs[0].get("data") or {}

# 业务字段来自实测观察、并非保证的 schema,请用防御式读取。
stats = data.get("userInfo", {}).get("stats", {})
print(stats.get("followerCount"), stats.get("videoCount"))
Shell
curl -X POST https://api.sandbase.ai/v1/api/tiktok/web/user-profile \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uniqueId": "tiktok"}'

数据端点都是 sync 模式,请求返回的 JSON 就是最终结果。响应里有一个不透明的运行 id,但同步调用完成后不需要轮询。外层结构包括这个 id、一个 status(成功时是 completed)、model 名称,再加一个 outputs 数组,数据放在它唯一那个元素的 data 里。

实测于 2026-10-01(UTC),使用 TikTok 官方公开账号 @tiktok:上面的请求({"uniqueId": "tiktok"})返回 HTTP 200、completed(run id 09009757-3492-46d2-8528-2824b652a149)。以下为真实返回,只保留少数字段;这些业务字段仅为实测观察、并非保证的 schema,实时数值也会变化:

JSON
{
  "id": "09009757-3492-46d2-8528-2824b652a149",
  "status": "completed",
  "model": "tiktok/web/user-profile",
  "outputs": [
    {
      "data": {
        "statusCode": 0,
        "userInfo": {
          "user": {
            "uniqueId": "tiktok",
            "nickname": "TikTok",
            "verified": true,
            "privateAccount": false
          },
          "stats": {
            "followerCount": 96000000,
            "followingCount": 1,
            "heartCount": 464800000,
            "videoCount": 1508
          },
          "statsV2": {
            "followerCount": "95990217",
            "heartCount": "464828930",
            "videoCount": "1508"
          }
        }
      }
    }
  ]
}

这次调用里,stats 是取整后的整数,statsV2 是字符串形式的精确数值,取用时请明确选一个。

如果 status 是 failed 或 timeout,响应里会有 error(带 type 和脱敏过的 message),且不会有 outputs,所以取 outputs[0].data 之前先判断一下 status。不同端点的响应结构不一样——资料在 outputs[0].data.userInfo 这一层,而像 tiktok/web/aweme-id 这种链接转 ID 的调用,data 直接就是那个 ID 字符串:2026-10-01 用参考页的示例链接 {"url": "https://www.tiktok.com/@owlcitymusic/video/7218694761253735723"} 调用,返回 "outputs": [{"data": "7218694761253735723"}](run id 327f1f39-07a1-4868-a364-e58a8e39db2b)。每个端点都先打一条真实响应,把路径对准。

SandBase 上某个 TikTok 端点的 API 参考文档,展示 vendor-qualified URL、cURL 示例和响应结构 API 参考文档写明了这套约定:调用 vendor-qualified URL,body 里只放该操作的参数。

能力速查

能力簇代表端点典型用途
资料与统计tiktok/web/user-profile把用户名解析成资料和粉丝/点赞数
粉丝 / 关注tiktok/app-v3/user-follower-list受众与关系网分析(分页)
视频与详情tiktok/web/user-post、tiktok/web/post-detail内容监控、互动追踪
评论tiktok/app-v3/video-comments情感与评论分析
搜索tiktok/app-v3/video-search-result按关键词找视频
Creative Center 趋势tiktok/ads/* 这一组创意与趋势研究(逐端点核实)
店铺tiktok/shop-web/product-detail商品与评价数据
ID 工具tiktok/web/aweme-id从链接提取视频 ID

app-v3 上的一些列表端点用 page_token 和 min_time 分页(不是 max_id 游标),且 count 上限为 20——web 和 app-v3 两套 surface 的分页约定不同,以每个端点的 schema 为准。

SandBase TikTok Endpoints 列表,显示用户、视频、评论、店铺等端点及其路径 TikTok 端点列表的一部分,覆盖 web、app、ads、shop 等 surface。

常见用例

用 TikTok profile API 做达人发现

先用 tiktok/web/user-profile 解析账号,再读 stats.followerCount、stats.heartCount 和视频数,按体量和互动筛出候选达人。输入:一个用户名或一批候选。输出:每个达人一条可对比的资料记录。端点:user-profile,需要先找候选时配合 tiktok/app-v3/video-search-result。按关键词搜创作者、读主页、按播放和点赞给作品排序的完整工作流,看 TikTok 创作者研究教程。

用 TikTok video API 做竞品监控

定时拉某竞品的近期帖子和指定视频详情,比较不同时间点的互动变化。输入:一个用户名或视频链接。输出:带计数的视频时间序列。端点:tiktok/web/user-post 和 tiktok/web/post-detail。

用 TikTok Creative Center API 做趋势研究

拉热门话题、热门广告案例等公开的趋势与创意研究信号,按市场、行业和时间范围为创意研究提供依据。输入:市场、可选行业和时间范围。输出:排序后的趋势或广告案例榜单。端点:tiktok/ads/* 这一组;动手前请对照该端点的线上 API 参考确认确切端点和参数,因为可用性会有差异。

TikTok Shop 方面,看 TikTok Shop 选品调研教程:按关键词搜商品、看评分和评价、拉出卖家的整店商品。

边界与限制

  • 只读公开数据。 这些端点只读公开资料和内容,不能发帖、关注或私信,私密账号也拿不到。
  • 注意速率和量级。 数据能不能拿到、拿多全,都按尽力而为对待:空结果和 HTTP 429 要做好退避重试;控制并发与节奏,接入更高量级的任务前先按线上 catalog 确认可用端点。
  • 参数和结构跟着上游 surface 走。 参数名常是驼峰(uniqueId、secUid),web 和 app-v3 的分页方式不同,响应字段也因端点和版本而异。先拉一条真实响应、读端点 schema,再动手写。
  • 并非每个列出的端点都能直接调或属于公开数据。 部分条目返回 HTTP 404,tiktok/creator/* 分析端点需要登录态,见上文依赖登录态与暂不可调用的端点。以线上 API 参考为准再基于某个端点开发。
  • 这不是和 TikTok 的官方合作。 SandBase 只是把公开数据的接入方式统一了;具体怎么用,请自行遵守 TikTok 的条款和相关隐私规定。

常见问题

需要 TikTok 开发者应用或 Login Kit 吗? 不需要。你用 SANDBASE_API_KEY 向 SandBase 鉴权,不必注册 TikTok 应用,也不用为这些读取端点管理 OAuth。

为什么有些参数是驼峰写法,比如 uniqueId? TikTok 的参数名跟随上游 API surface。web surface 常用 uniqueId 和 secUid;别默认 snake_case,始终以端点 schema 为准。

分页怎么用? 取决于 surface。app-v3 的若干列表端点用 page_token 加 min_time,且 count 上限 20;首次请求省略 token,之后传上一页返回的值。以每个端点的 schema 为准。

能读私密账号或需登录才能看的数据吗? 不能。API 只返回公开数据。私密账号、私信,以及任何得登录成某个用户才能做的操作,都不在范围内。

某个任务该调哪个端点? 先按上面的能力速查表把任务对到能力簇,再读端点 schema。例如取资料统计用 tiktok/web/user-profile,取视频列表用 tiktok/web/user-post,取评论用 tiktok/app-v3/video-comments。

能拿 Creative Center 趋势和店铺数据吗? 可以。tiktok/ads/* 这组覆盖公开的创意与趋势研究(如热门话题、热门广告案例),tiktok/shop-web/* 这组覆盖公开的商品详情、评价(product-reviews-v2)、分类和卖家列表。各端点可用性有差异,动手前请对照该端点的线上 API 参考确认确切路径。

触发限流会怎样? 高负载下可能返回 HTTP 429。用有上限的指数退避重试;控制并发与节奏,而不是全速循环打单条调用。

从一次资料请求开始

先创建一把 SandBase API Key,拿一个公开用户名跑 tiktok/web/user-profile,把返回的结构看清楚,再扩展到视频、评论、广告或店铺数据。准备好了就:

觉得有用?分享给更多人