您需要通过用户名以编程方式获取 TikTok 用户的个人资料和粉丝统计信息,并且您需要在本周内完成。通过本指南,您将使用单个 HTTP GET 检索用户详细信息(ID、昵称、验证、粉丝数量等),并且您将知道如何将其链接到视频检索和项目详细信息查找。
为什么选择这个 API 及其返回内容
Zyla API Hub 上的 TikTok 公共媒体 API 提供只读端点以提取公共 TikTok 数据。通过它,您可以:
- 将 TikTok 用户名解析为完整的个人资料(ID、secUid、昵称、头像 URL、验证状态和粉丝统计信息)。
- 通过其 secUid 获取用户发布的视频。
- 通过 URL 或 ID 获取特定 TikTok 视频或照片的详细信息。
这对于社交仪表板、CRM 增强、创作者分析、内容监控以及需要可重现访问公共 TikTok 元数据的服务器端自动化非常有用。
Zyla API Hub 将数千个 API 集中在一个密钥和一个订阅模型下。您可以在 zylalabs.com 探索超过 10,000 个公共 API,并在无需管理多个供应商的情况下进行订阅。
在 Zyla API Hub 上开始
要尝试这些端点,请打开 TikTok 公共媒体 API 列表并开始试用。您将收到一个 API 密钥,以放置在授权头中。
- 前往列表: 开始 7 天试用 TikTok 公共媒体 API。
- 点击订阅或开始免费试用(可用时)以获取您的密钥。
- 在每个请求中使用 Authorization: Bearer YOUR_API_KEY。
计费为订阅 + 配额(不是按调用计费)。有关当前访问选项和定价,请始终检查 API 页面。您还可以使用相同的帐户和密钥浏览 Zyla API Hub 上的其他类别。
您将使用的端点
1) 获取用户详细信息 — 将用户名解析为个人资料和统计信息
方法: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
描述: 使用用户名检索 TikTok 用户的详细个人资料信息。返回用户元数据,例如粉丝数量、关注数量和个人资料详细信息。
所需参数: username (string)
使用 username = _ttqueen 的示例:
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"
官方响应示例:
{
"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.nickname: UI 的处理和显示名称。data.hdAvatarUrlList: 高质量头像 URL。data.isVerified: 验证指示符。data.statistics: 用于 KPI 的粉丝/关注/心/视频计数。data.secUid: 必须用于通过下一个端点检索用户的视频。
2) 获取视频列表 — 按 secUid 列出视频
方法: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
描述: 使用其 secUid 检索 TikTok 用户发布的视频列表。返回视频元数据,包括 ID、描述和统计信息。
所需参数: secUid (string)
您可以从获取用户详细信息的响应中获得 secUid。将其提供给此端点以列举创作者的帖子。
请求 URL 形状示例(不要忘记授权头):
https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
3) 获取视频或照片详细信息 — 检查特定帖子
方法: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
描述: 通过 ID 或 URL 检索 TikTok 视频详细信息,包括描述统计信息、作者信息和媒体 URL。
所需参数: idOrUrl (string)
提供 TikTok 项目 URL 或其 ID 以接收该单个帖子的详细元数据。示例参数值:
https://www.tiktok.com/@khaby.lame/video/7661681676719869214?lang=en
工作流程:从用户名到用户详细信息(及其他)
- 调用获取用户详细信息,使用目标用户名解析:
- 用户身份和头像:在您的个人资料页面或 CRM 记录中显示。
- 粉丝和视频计数:填充指标和健康指标。
- secUid:存储它;您将需要它来列出视频。
- 可选地,使用返回的 secUid 调用获取视频列表,以列举供稿或分析的最新内容。
- 可选地,使用选定的视频 URL 或 ID 调用获取视频或照片详细信息以进行深入分析(例如,在单击时显示每个帖子的详细信息)。
快速 Python 示例:获取用户详细信息并读取核心字段
此示例调用获取用户详细信息,提取个人资料的基本信息和粉丝统计信息,并展示如何在计划稍后获取视频时保留 secUid。
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_USER_DETAIL = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
def get_user_detail(username: str) -> dict:
url = f"{BASE_USER_DETAIL}?username={username}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
username = "_ttqueen"
data = get_user_detail(username)
user = data.get("data", {})
stats = user.get("statistics", {})
print("用户 ID:", user.get("id"))
print("唯一 ID:", user.get("uniqueId"))
print("昵称:", user.get("nickname"))
print("已验证:", user.get("isVerified"))
print("头像 URL:", (user.get("hdAvatarUrlList") or [None])[0])
print("粉丝:", stats.get("followerCount"))
print("关注:", stats.get("followingCount"))
print("心:", stats.get("heartCount"))
print("视频数量:", stats.get("videoCount"))
print("secUid(用于视频列表):", user.get("secUid"))
注意:
- 授权是带有您从 API 列表中获取的密钥的 Bearer 头。
- 在索引之前始终检查缺失字段,以避免 KeyError。
- 将
id或uniqueId作为您的本地外键进行持久化,并在稍后获取视频时保留secUid。
节省时间的实用细节
- 身份验证:所有端点都需要授权头,格式为 Authorization: Bearer YOUR_API_KEY。
- 数据新鲜度:将粉丝和心计数视为时间点值。如果您缓存,请根据产品的需求决定刷新频率。
- 时间戳:获取视频时,您将看到数字
createdAt值。根据您所需的时区和格式在应用程序中对其进行标准化。 - 标识符:存储
id和uniqueId以提高弹性;需要secUid来列出用户的视频。 - 错误处理:使用 HTTP 状态代码和字段的存在/缺失来分支逻辑。记录请求 URL 和用户名以进行重试。
- 配额:API 使用订阅 + 配额模型。检查列表以获取当前限制和可用的 7 天试用。
您本周可以交付的用例
- 创作者查找小部件:输入用户名,立即显示头像、验证徽章和粉丝数量。
- CRM 增强:将 TikTok ID 和粉丝统计信息存储在影响者记录旁边。
- 审核/策划工具:解析一个句柄,然后获取他们的视频以构建审核队列或精彩集锦。
- 报告作业:每晚任务刷新粉丝、心和视频计数,以支持分析仪表板。
通过 MCP 从 AI 代理调用此 API
如果您使用代码助手或代理 IDE 进行自动化,您可以通过 MCP 端点调用任何 Zyla API。配置您的 MCP 兼容客户端指向:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
这使得 TikTok 公共媒体 API 可以作为工具从像 Claude Code、Cursor、Windsurf 等客户端调用。有关更多信息,请参见 MCP 页面。
链接其他端点(可选模式)
在解析个人资料后获取用户的视频
一旦您从获取用户详细信息中读取 secUid,请将其发送到:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
使用此功能填充“最近上传”选项卡或在项目之间运行分析。
获取特定项目的详细信息
当用户在您的 UI 中单击视频时,通过将 TikTok URL 或 ID 传递给以下内容来获取详细信息:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details?idOrUrl=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame%2Fvideo%2F7661681676719869214%3Flang%3Den
这对于项目级页面、预览和服务器端链接展开非常方便。
一分钟验证清单
- 授权头存在且格式正确。
- 当需要时,用户名字符串进行 URL 编码。
- 存储用户个人资料中的
id、uniqueId和secUid以进行后续操作。 - 优雅地处理空数组,例如
hdAvatarUrlList。 - 记录请求 URL 以便于可重现的错误报告。
常见问题解答
我如何验证我的请求?
在每次调用中包含 Authorization: Bearer YOUR_API_KEY。通过订阅或开始试用从 API 列表中获取您的密钥。
我在哪里可以获得视频列表端点所需的 secUid?
使用用户名调用获取用户详细信息;响应中包含 data.secUid。使用该值与获取视频列表。
我可以直接传递 TikTok 视频 URL 以获取详细信息吗?
可以。使用获取视频或照片详细信息并将 idOrUrl 参数设置为 TikTok URL 或项目 ID。
定价和配额是什么?
访问为订阅 + 配额(不是按调用计费)。检查 API 页面以获取当前访问选项。列表上提供 7 天试用。
是否有免费计划?
没有免费计划。使用列表上的 7 天试用进行评估,然后选择适合您使用情况的订阅。
准备好交付您的用户详细信息集成了吗?在此处获取您的密钥并开始使用官方端点进行测试: 开始 7 天试用 TikTok 公共媒体 API。一个帐户和一个密钥可以在 Zyla API Hub 上的数千个 API 中使用。