TikTok Scraper API

采集为异步：提交 run → 轮询 → 取数。完整流程见 快速开始；统一响应信封 / run 状态机 / 计费 / 错误码见 认证与错误处理。本页只列各端点的 target 字段与输出字段。

快速说明

• Base URL：https://api.antsdata.com/v1
• 方法与路径：提交 run 均为 POST /v1/scraper/tiktok/<资源>；轮询/取数/下载走通用的 GET /v1/scraper/runs/{id}（见快速开始）
• 鉴权：请求头 Authorization: Bearer ants_xxx（静态 API Key）
• Content-Type：application/json
• 提交体：统一 { "deliveryMode": "async", "recordLimit": 1000, "targets": [ … ] }；targets[] 每个元素的字段见下方各端点「target 字段」，一个 run 可含多个 target（逐目标成败看轮询返回的 tasks[]）。

💡 也可用 deliveryMode: "sync" 同步模式（小任务阻塞等终态，超时自动 fallback 转轮询）——详见 快速开始 · 同步模式。

端点一览

profile 与 profile-url 底层出参一致，区别只在入参入口：profile 以用户名为主，profile-url 以主页链接为主（两者均可另传对方字段，二选一即可）。

Profile — 账号资料（用户名搜索）

POST /v1/scraper/tiktok/profile

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "username": "khaby.lame" },
      { "username": "nike" }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

Profile URL — 账号资料（主页链接搜索）

POST /v1/scraper/tiktok/profile-url

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/profile-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "profileUrl": "https://www.tiktok.com/@khaby.lame" }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

Videos — 用户视频

POST /v1/scraper/tiktok/videos

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "username": "khaby.lame", "sortBy": "popular" }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

Hashtag — 话题视频

POST /v1/scraper/tiktok/hashtag

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/hashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "hashtag": "comedy" }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

Search — 搜索视频

POST /v1/scraper/tiktok/search

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "keyword": "web scraping" }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

Comments — 评论

POST /v1/scraper/tiktok/comments

target 字段（targets[] 每个元素）：

输出字段（取数时 records 的 items[] 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/tiktok/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      {
        "videoUrl": "https://www.tiktok.com/@khaby.lame/video/7641693768831225101",
        "commentsLimit": 100,
        "includeReplies": true
      }
    ]
  }'

返回 HTTP 201 + { "id": <run 号>, "status": "queued" }，随后按快速开始轮询取数。

取数

提交后 GET /v1/scraper/runs/{id} 轮询至 succeeded，再 GET /v1/scraper/runs/{id}/records?page=1&pageSize=20 分页取数，或 GET /v1/scraper/runs/{id}/download?format=json|csv|excel 下载整份产物（端到端示例详见快速开始）。

下一步

• 平台指南： X · Instagram · Facebook · LinkedIn · Google · YouTube · Amazon
• 同步搜索：Google SERP
• 认证与错误处理 — 统一响应信封、run 状态机、计费与错误码

FAQ

Q: 一个 run 能采集多个账号 / 话题 / 关键词吗？

可以。targets 是数组，一个 run 可含多个目标，逐目标成败见轮询返回的 tasks[]（详见认证与错误处理）。

Q: profile 与 profile-url 有什么区别？

两者出参完全一致，区别只在入参入口：profile 按用户名采集、profile-url 按主页链接采集。两个端点都可另传对方字段（username / profileUrl 二选一），按手头已有的标识选端点即可。

Q: 私密或不存在的账号怎么处理？

该目标在 tasks[] 中标为 failed 并带 errorMessage，其余目标照常出数；失败目标不计费（部分成功照常按成功条数结算）。

Q: 账号视频为什么不再有 searchMode？

原先用 searchMode（user/hashtag/keyword）合并的能力已拆成三个独立端点：账号视频用 /videos，话题用 /hashtag，关键词用 /search。请按端点选择，不再传 searchMode。

Q: comments 的时间戳是什么格式？

create_time 是 Unix 秒级时间戳（如 1781827200），需要可读时间请自行转换为 ISO 8601。

Q: 数据是实时的吗？

是。每个 run 都实时采集，返回目标平台当前的数据。