TikTok 粉丝查看 API

一次 POST 列出公开 TikTok 账号的粉丝——返回最多 50 个带完整元数据的粉丝资料。

一次 POST，最多 50 个资料
完整粉丝元数据
用户名输入灵活
样本量可控
幂等键支持
服务端持 key

请求示例

curl -X POST "https://api.agentbody.io/v1/tiktok/profile/followers" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"max_results":"1","username":"YOUR_USERNAME"}'

响应示例

来自 OpenAPI 规范的已文档化响应。

Sample of public follower profiles for the TikTok account.

{
  "items": [
    {
      "avatar_url": "https://example.com/avatar.jpg",
      "bio": "example bio",
      "display_name": "Example User",
      "followers": 1200,
      "following": 300,
      "likes": 45000,
      "profile_url": "https://www.tiktok.com/@example",
      "username": "example",
      "verified": false
    }
  ],
  "total": 1,
  "username": "khaby.lame"
}

功能特点

tiktok.profile_followers 操作列出一个 TikTok 资料的公开粉丝账号样本。API key 放在你的服务端；端点一次调用返回最多 50 个带公开元数据的粉丝资料。

一次 POST，最多 50 个资料

向 /v1/tiktok/profile/followers 发 POST，带 TikTok 用户名、@handle 或资料链接。成功的 200 返回 username、total 和 items——最多 50 个粉丝资料，每个九个元数据字段。

完整粉丝元数据

响应中每个 item 带 username、display_name、bio、profile_url、avatar_url、followers、following、likes 和 verified——每个粉丝账号的完整公开资料卡。

用户名输入灵活

username 参数接受裸用户名、@handle 或完整资料链接（tiktok.com/@username）。API 把三种格式归一到同一公开资料；私密或不存在的账号返回 400 或 502。

样本量可控

可选 max_results 参数设置返回的粉丝资料数，1 到 50。返回列表是粉丝集合的样本，不是完整粉丝列表。

幂等键支持

带 Idempotency-Key 头可以安全重试失败请求，不会重复扣费。网关按键去重——网络重试不会触发同一资料的第二次查询。

服务端持 key

端点需要放在你服务端的 AgentBody API key。绝不要把 key 写进客户端代码——所有调用走你的后端，保证 key 安全、用量可追踪。

使用步骤

三步把 TikTok 粉丝查询集成进你的系统。

获取 API key

注册免费 AgentBody 账户，在控制台生成 API key。key 用于认证每个请求并按余额计量。

POST 用户名

向 /v1/tiktok/profile/followers 发 POST，请求体带 TikTok 用户名、@handle 或资料链接。可选 max_results（1-50），带 Idempotency-Key 头安全重试。

拿到粉丝列表

成功的 200 返回账号用户名、条目数和粉丝资料数组。遍历 items 处理每个粉丝的用户名、显示名、简介、计数和认证标识。

常见问题

TikTok 粉丝查看 API 怎么工作？

向 /v1/tiktok/profile/followers 发 POST，带 TikTok 用户名、@handle 或资料链接。API 拉取该账号公开粉丝资料的样本，返回最多 50 个带完整元数据的资料。

支持哪些用户名格式？

username 参数接受裸用户名、@handle 或完整资料链接（tiktok.com/@username）。三种格式解析到同一公开资料。私密、已删除或不存在的账号返回 400 或 502。

返回的粉丝列表完整吗？

不完整。端点返回粉丝集合的样本，每次调用经 max_results 最多 50 个资料。设计用途是受众审计和研究抽样，不是穷举全部粉丝。

每个粉丝返回什么元数据？

每个 item 含 username、display_name、bio、profile_url、avatar_url、followers、following、likes 和 verified——TikTok 对账号公开的完整元数据。

端点返回哪些错误码？

400 表示用户名格式错误或不支持，401 表示 key 缺失或无效，409 表示幂等冲突，502/503/504 表示上游故障。失败不计费；上游错误用同一幂等键重试。

API 支持私密账号吗？

不支持。私密 TikTok 账号的粉丝列表只有被批准的关注者能看，API 对它们返回错误。只支持公开账号——任何声称能看私密账号粉丝的服务都不可信。