TikTok 头像下载器 API

通过一次 POST 下载 TikTok 头像。响应返回永久图片下载 URL 和完整个人资料元数据。

一次 POST，一张图片
永久下载 URL
灵活的用户名输入
完整个人资料元数据
幂等键支持
需要服务器端密钥

请求示例

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

响应示例

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

Direct TikTok profile picture link and normalized public profile metadata.

{
  "bio": "Example bio",
  "display_name": "Example Creator",
  "followers": 151200000,
  "following": 1537,
  "likes": 11300000000,
  "profile_picture_url": "https://p16-sign-va.tiktokcdn.com/example.jpeg",
  "profile_url": "https://www.tiktok.com/@example",
  "username": "example",
  "videos": 2346
}

功能特点

tiktok.profile_picture_download 操作从一个公开 TikTok 个人资料获取头像。您的服务器持有 API 密钥；端点在单次调用中返回永久下载 URL 和完整个人资料元数据。

一次 POST，一张图片

发送 POST /v1/tiktok/profile/picture/download 和 TikTok 用户名、@handle 或主页 URL。成功的 200 返回 username、display_name、bio、followers、following、likes、videos、profile_url 和 profile_picture_url——联系人或研究管道所需的一切在一个响应中。

永久下载 URL

profile_picture_url 指向完全保存的图片文件，而非过期的 CDN 跳转。它可从任何服务器、任何 IP、任何时间下载，因此您可以将其交给队列工作器、CRM 或直接交给最终用户，无需重新运行查找。

灵活的用户名输入

username 参数接受裸用户名、@handle 或完整主页 URL（tiktok.com/@username）。API 将三种格式标准化为同一公开个人资料；私密、已删除或不存在的账户返回 400 或 502 错误。

完整个人资料元数据

每个响应包含完整的公开个人资料：用户名、显示名称、简介文本、粉丝数、关注数、总点赞数、视频数和主页 URL——无论用户如何配置隐私设置，所有账户均一致。

幂等键支持

传递 Idempotency-Key 头以安全重试失败请求而不产生重复费用。网关按键去重，因此网络重试永远不会为同一个人资料触发第二次查找。

需要服务器端密钥

端点需要服务器持有的 AgentBody API 密钥。绝不在客户端代码中暴露密钥；通过后端路由所有调用以保持密钥安全并跟踪使用量。

使用步骤

通过 API 三个步骤集成 TikTok 头像下载。

获取 API 密钥

创建免费 AgentBody 账户并从仪表板生成 API 密钥。密钥验证每个请求并跟踪您的余额使用量。

POST 用户名

向 /v1/tiktok/profile/picture/download 发送 POST 请求，请求体中包含 TikTok 用户名、@handle 或主页 URL。包含 Idempotency-Key 头以安全重试。

接收下载链接

成功的 200 响应返回永久 profile_picture_url 和完整个人资料元数据。直接从链接下载图片，或将其交给媒体管道进行存储和分发。

常见问题

TikTok 头像下载器 API 如何工作？

向 /v1/tiktok/profile/picture/download 发送 POST 请求和 TikTok 用户名、@handle 或主页 URL。API 获取个人资料，保存头像图片，并返回永久下载 URL 以及完整的公开个人资料元数据。

支持哪些用户名格式？

API 接受裸用户名（charlidamelio）、@handle（@charlidamelio）或完整主页 URL（https://www.tiktok.com/@charlidamelio）。三种格式解析为同一公开个人资料。

响应格式是什么？

成功的 200 响应返回 JSON 对象：username、display_name、bio、followers、following、likes、videos、profile_url 和 profile_picture_url（永久图片下载链接）。

有速率限制或使用上限吗？

每次成功下载按网关管理的价格从您的 AgentBody 余额中扣除固定金额。除账户余额外无单独速率限制；失败请求（400、502 等）不计费。使用 Idempotency-Key 头防止重试产生重复费用。

可以从私密 TikTok 账户下载头像吗？

不可以。API 只能处理公开可用的个人资料。私密账户、已删除账户和受限个人资料被 TikTok 平台拒绝，返回 400 或 502 错误。

使用此 API 下载 TikTok 头像合法吗？

仅将 API 用于公开可用的头像，用于合法目的，如研究、验证或设计参考。尊重隐私权和 TikTok 服务条款。不要使用下载的图片冒充他人或侵犯其权利。