通过用户名查询 TikTok 账号资料
查看 TikTok 用户、视频与音乐数据 API 的全部接口 →通过必填的字符串路径参数 username 查询 TikTok 账号资料，例如 khaby.lame。此接口用于查询已知用户名，不是按关键词发现用户。已观察到的成功请求返回 HTTP 200，包含 status=ok、data.status_code=0 和 data.user 对象。观察到的用户字段包括 unique_id（用户名）、uid（账号标识）、nickname（显示名称）、follower_count（返回的粉丝数）和 aweme_count（返回的作品数）。khaby.lame 样本中的 unique_id=khaby.lame、uid=127905465618821121；其中的计数仅反映采集时点，不代表当前数值或历史总量。使用不存在的测试用户名发起请求时，返回 HTTP 404，包含 status=error、error=not found 和 error_description=resource not found。应将这一已观察到的未找到响应视为查询结果，而非服务故障，同时单独处理其他失败情况。上述字段来自已有请求观察记录，没有独立响应示例可用于确认更多字段。保存账号资料时请记录采集时间，将计数变化解释为不同快照之间的差异，而非历史分析数据流。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/tiktok/user-data-by-username API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tiktok/user-data-by-username?key=<API_KEY>&username=khaby.lame'
查询结果
使用场景
- 审核候选创作者名单时，将输入的用户名与返回的 unique_id、uid、nickname 核对，再把账号计数加入审核卡片。
- 将已知用户名解析为 data.user.uid，供后续按用户 ID 查询使用，同时保留原始用户名便于追溯。
- 为已知账号的监测面板保存带采集时间的 follower_count 与 aweme_count 快照，并将差异标记为观察到的计数变化。
- 遇到与已观察样本一致的 HTTP 404 错误结构时，展示专门的账号资料未找到状态，而非笼统提示服务故障。
常见问题
username 参数应该填写什么？
填写 TikTok 账号的用户名字符串，例如文档中的 khaby.lame。此路由查询已知用户名，不接受显示名称、数字用户 ID 或关键词搜索条件。
成功查询中已观察到哪些资料字段？
HTTP 200 样本包含 status=ok 和 data.status_code=0；其 data.user 对象中观察到 unique_id、uid、nickname、follower_count 和 aweme_count。现有证据尚未确认其他账号资料字段。
如何将用户名转换为 TikTok 用户 ID？
从成功的账号资料响应中读取 data.user.uid。已观察到的 khaby.lame 资料返回 uid=127905465618821121、unique_id=khaby.lame。请将该值作为标识符保存，不要为算术运算而转换。
测试中，不存在的用户名会返回什么？
未找到账号的测试返回 HTTP 404，包含 status=error、error=not found 和 error_description=resource not found。请将这种响应作为资料未找到处理，并将无关的 HTTP 错误或响应格式异常放入独立的失败处理流程。
follower_count 和 aweme_count 是历史分析数据吗？
不是。已观察到的这两个字段是请求时返回的账号计数：follower_count 表示粉丝数，aweme_count 表示作品数。如需比较快照，请自行保存采集时间；此接口并未说明提供历史分析时间序列。