获取用户详细信息的API

您需要将TikTok用户的个人资料和关注者统计信息提取到您的应用中，而无需构建抓取器或反向工程标题。在本指南结束时，您将查询一个真实的端点，该端点通过用户名返回用户元数据（关注者、关注、个人资料字段），并且您将知道如何将其链接以提取他们的内容，以便进行用户管理工作流程，例如个人资料仪表板和审核队列。

此API的功能及使用时机

Tiktok公共媒体API公开只读端点，用于处理公共TikTok用户数据。关键的用户管理功能是通过用户名检索用户的详细个人资料，其中包括关注者和关注者计数、个人资料字段以及您可以用于后续调用的ID。典型的应用包括：

• 构建一个用户个人资料面板，显示关注者趋势和基本统计信息。
• 通过查找用户名并确认预期的元数据来验证TikTok帐户连接。
• 通过解析其不可变标识符（例如，secUid）来播种用户的内容工作流程，以提取他们的视频。

所有端点都可以在Zyla API Hub上找到，位于Tiktok公共媒体API下，您可以使用一个帐户、一个API密钥和订阅+配额模型在Zyla API Hub上探索超过10,000个公共API。

在Zyla API Hub上入门

打开Zyla API Hub上的API列表页面，选择订阅或在可用时开始7天试用。第一个API可以通过7天试用或50个请求进行尝试。没有免费计划；请查看API页面以获取当前访问选项和定价。在订阅后，您将收到一个API密钥。

• 身份验证：使用标题Authorization: Bearer YOUR_API_KEY传递您的密钥
• 基本调用模式：使用下面在zylalabs.com上记录的确切端点URL
• 计费：订阅+配额（不是按调用计费）

您将用于用户管理的端点

1) 获取用户详细信息

使用用户名检索TikTok用户的详细个人资料信息。这将返回用户元数据，例如关注者计数、关注计数和个人资料详细信息。

• 方法：GET
• URL：https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
• 所需请求参数：
  • username（字符串）：TikTok用户名，例如：_ttqueen

官方cURL示例（复制/粘贴）：

curl -s -X GET "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail?username=_ttqueen" \
-H "Authorization: Bearer YOUR_API_KEY"

官方JSON响应：

{
"data": {
"id": "6644110999556227073",
"nickname": "Quynh Truong",
"signature": "Thấy mình đáng iu thì fl mình nhé hehee
💬For work: 097.136.3242",
"hdAvatarUrlList": [
"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/dcb917fff48aacab462620b08f13b4e0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=c1870c0f&x-expires=1790154000&x-signature=nO62jhA4bUQvXuz5YAr8WEwl6ns%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a"
],
"uniqueId": "_ttqueen",
"secUid": "MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L",
"isVerified": false,
"statistics": {
"followerCount": 3100000,
"followingCount": 139,
"friendCount": 84,
"heartCount": 117100000,
"videoCount": 559,
"diggCount": 0
}
}
}

您将实际使用的字段说明：

• data.id：数字用户ID（字符串）。在您的数据库中用作稳定键。
• data.uniqueId：您查找的公共用户名。
• data.secUid：其他端点所需的安全范围唯一标识符（例如，提取用户的视频列表）。
• data.hdAvatarUrlList：用于个人资料显示的头像图像URL列表。
• data.statistics.*：followerCount、followingCount、heartCount、videoCount是个人资料KPI的关键。
• data.isVerified：用于徽章显示和审核路由的布尔标志。

2) 获取视频列表

使用secUid检索TikTok用户发布的视频列表。返回视频元数据，包括ID、描述和统计信息。

• 方法：GET
• URL：https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
• 所需请求参数：
  • secUid（字符串）：使用从获取用户详细信息（data.secUid）返回的确切值

注意：

• 响应包括data.awemeList数组。每个项目都有id、url、描述、createdAt（UNIX时间戳，秒）、contentType和作者详细信息等字段。
• 使用createdAt按时间顺序对内容进行排序。时间戳是表示自UNIX纪元以来的秒数的整数；在您的UI中转换为您的本地时区。

3) 获取视频或照片详细信息

通过ID或URL检索TikTok视频详细信息，包括描述、统计信息、作者信息和媒体URL。

• 方法：GET
• URL：https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
• 所需请求参数：
  • idOrUrl（字符串）：传递TikTok视频URL或ID

注意：

• 在从列表视图中选择项目时，使用此功能丰富用户的内容详细信息页面。
• 响应包括适合在审核或管理面板中预览内容的作者字段和媒体链接。

用户管理仪表板的端到端流程

1. 通过使用获取用户详细信息按用户名解析用户。
2. 存储标识符（id、uniqueId、secUid）以及用户记录的统计信息。
3. 在需要时，使用返回的secUid通过获取视频列表提取他们的内容。
4. 对于所选帖子，使用其URL或ID调用获取视频或照片详细信息以呈现详细视图。

这反映了大多数生产仪表板如何保持以id和secUid为键的规范用户记录，同时定期刷新统计信息，同时按需提取内容以控制延迟和成本。

节省时间的实际实施细节

• 身份验证：每个请求必须包括Authorization: Bearer YOUR_API_KEY。
• 时间戳：内容端点返回的createdAt字段是UNIX纪元秒（UTC）。根据您产品的时区政策进行转换。
• 缓存：如果您对多个个人资料轮询关注者计数，请缓存获取用户详细信息的响应（例如，5-15分钟）。这减少了重复请求并平滑了UI加载。
• 标识符：secUid是提取内容所需的。在第一次查找后立即持久化，以避免稍后额外调用。
• 配额：访问是订阅+配额。第一个API可以通过7天试用或50个请求进行尝试。在您的Zyla仪表板中监控使用情况。

Python示例：解析用户并显示个人资料统计信息

此示例调用获取用户详细信息，提取核心用户管理字段，并打印紧凑的个人资料摘要。将YOUR_API_KEY替换为您的密钥。

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
USERNAME = "_ttqueen"

url = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
params = {"username": USERNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})

user_id = data.get("id")
unique_id = data.get("uniqueId")
sec_uid = data.get("secUid")
nickname = data.get("nickname")
avatar_urls = data.get("hdAvatarUrlList", [])
stats = data.get("statistics", {}) or {}

summary = {
"id": user_id,
"username": unique_id,
"nickname": nickname,
"followers": stats.get("followerCount"),
"following": stats.get("followingCount"),
"videos": stats.get("videoCount"),
"hearts": stats.get("heartCount"),
"verified": data.get("isVerified"),
"secUid": sec_uid,
"avatar": avatar_urls[0] if avatar_urls else None
}

print(summary)

从这里，您可以持久化id和secUid以进行下游内容调用，并在您的UI的个人资料头部显示summary["avatar"]。

错误处理和操作提示

• 重试预算：网络波动会发生。对于幂等的GET请求（例如，2-3次重试），使用小的重试策略和指数回退。
• 输入验证：仅传递记录的参数。对于用户查找，确保用户名字符串与您从用户收集的预期TikTok用户名格式匹配。
• 部分数据：像hdAvatarUrlList这样的数组可能为空；如示例所示，防止缺失字段。
• 调度：如果您定期刷新关注者统计信息，请错开请求以避免峰值并保持在配额内。

现实世界用户管理用例

• 身份解析：当用户在您的产品中连接他们的TikTok时，通过用户名调用获取用户详细信息以验证所有权（显示昵称、头像、关注者计数以确认）。
• 管理员个人资料：构建内部页面，显示用户身份（id、uniqueId、nickname）、验证徽章和摘要统计信息（关注者、心、视频）以便快速审核。
• 增长快照：持久化来自统计信息的每日汇总，以跟踪关注者计数和视频计数随时间的变化。
• 审核队列：将获取视频列表与获取用户详细信息中的secUid结合，以预取最近的内容到审核队列中。

通过MCP从AI代理调用API

如果您使用MCP兼容客户端（Claude Code、Cursor、Windsurf）协调任务，您可以通过MCP端点调用Zyla API。相同的Authorization标题适用；您的客户端处理工具调用。

• MCP端点：MCP（当您的工具需要时，将您的apikey作为查询参数附加：apikey=YOUR_API_KEY）
• 对于接受直接HTTP调用的工具，使用上面显示的确切hub URL，并设置Authorization标题。

这使得代理可以通过用户名检索用户详细信息，解析secUid，然后提取视频，所有这些都在编码会话或自动化中进行，而无需离开您的编辑器。

集成检查清单

• 在Zyla上订阅并获取您的API密钥。
• 通过用户名实现获取用户详细信息；持久化id和secUid。
• 呈现个人资料：昵称、头像（hdAvatarUrlList中的第一个项目）、isVerified徽章、统计信息。
• 添加作业或按需调用以在需要时使用secUid提取用户的视频。
• 将请求包装在重试和最小缓存（例如，5-15分钟）中，以获取个人资料统计信息。
• 在您的Zyla仪表板中监控配额，并相应地调整轮询频率。

常见问题解答

问：身份验证需要哪个标题？
答：在每个请求中使用Authorization: Bearer YOUR_API_KEY。

问：在通过用户名查找用户后，如何提取用户的视频？
答：调用获取用户详细信息以获取data.secUid，然后将该secUid传递给获取视频列表端点。

问：createdAt时间戳是什么时区的？
答：createdAt值是UNIX纪元秒（UTC）。在您的UI中转换为您所需的时区。

问：定价是按调用计费吗？
答：不。Zyla使用订阅+配额模型。第一个API可以通过7天试用或50个请求进行尝试。请查看API页面以获取当前访问选项和定价。

问：我可以在AI编码代理中使用这个吗？
答：可以。通过Zyla MCP端点调用相同的hub端点，使用您的API密钥；MCP兼容客户端可以直接调用工具。

准备将其集成到您的应用中吗？从官方列表开始，获取您的密钥，并立即进行第一次请求：在Tiktok公共媒体API上开始7天试用。随时在Zyla API Hub上探索更多API。