TikTok Scraper 快速开始

使用 User Detail actor 获取一个 TikTok 账户的个人资料。本演练使用官方 User Detail 示例中的用户名和请求。

开始之前

你需要一个 Scrapeless 账户、一个有效的 API key 以及 cURL。请在 Scrapeless 控制台获取你的 key。

1. 发送个人资料请求

将 YOUR_API_KEY 替换为你的 key。你可以将 teamtrump 替换为你想要获取的用户名。与官方示例一样，传入用户名本身，而不是个人资料 URL。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.user.detail",
  "input": {
    "unique_id": "teamtrump"
  }
}'

actor 选择 scraper.tiktok.user.detail。必需的 input.unique_id 用于标识该账户。

2. 读取已完成的结果

HTTP 200 响应会返回个人资料数据。以下是已发布响应示例的一个子集，而非一次全新的抓取：

{
  "account_id": "7365161718782395438",
  "unique_id": "teamtrump",
  "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
  "nickname": "Team Trump",
  "profile_url": "https://www.tiktok.com/@teamtrump",
  "is_verified": true
}

完整示例还包括 avatar 和 statistics。其 statistics 的值为字符串。如果你想使用 User Work 请求该账户的帖子，请从你已完成的结果中保存实际的 sec_uid。

3. 获取仍在处理中的任务

如果你收到 HTTP 201，请从响应中读取 taskId，并替换下方的 YOUR_TASK_ID：

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

有关轮询间隔和重试限制，请参阅结果与轮询。请复用返回的任务 ID，而不要创建重复的个人资料请求。

如果请求失败

请检查 HTTP 状态码和响应体。User Detail 参考文档记录了一个带有 code 和 message 的 400 响应，并包含错误示例 code: 20500、message: "scraping failed"。在重试之前，请检查输入的用户名和身份验证信息。

后续步骤

继续前往 Endpoints，使用 sec_uid 请求帖子，或使用 product_id 和 region 获取某个 Shop 商品。