适用场景抖音用户公开信息 API 适用于以下场景数据分析获取用户主页的公开指标粉丝数、获赞数、作品数用于内容运营或竞品分析。内容监控定期拉取指定用户的公开数据监控其账号增长趋势。工具集成在自有后台或应用中展示目标用户的概览信息如昵称、头像。该 API 仅需一个用户主页链接支持短链v.douyin.com或长链douyin.com/user/即可一次性获取多个维度数据无需模拟浏览器或处理 Cookie大大降低了接入维护复杂度。接口能力边界请求方式GET请求地址https://v1.apizero.cn/api/douyin-user返回格式JSONQPS 限制5 次/秒超出会返回限流错误数据范围仅返回用户在抖音上公开显示的信息不包含私密数据如私信数、主页浏览量。自动展开短链如果传入v.douyin.com短链接口会自动重定向解析返回最终用户的数据。注意该接口一次请求只能获取一个用户的信息不支持批量查询。如需批量查询需在业务层循环调用并控制频率。参数与鉴权Query 参数参数类型必填说明urlstring是抖音用户主页链接。支持格式https://v.douyin.com/xxxx/或https://www.douyin.com/user/MS4wLjAB...鉴权方式在请求 Header 中携带X-API-Key字段值为你的 API Key。示例 HeaderX-API-Key: your_api_key_hereAPI Key 需要在 API 平台申请获取每个 Key 有独立的 QPS 和调用配额。完整请求模板curl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/douyin-user?urlurl最小可运行示例以下示例使用curl调用接口。请将YOUR_API_KEY替换为你的真实 API Key并将用户主页链接替换为目标用户的完整主页链接示例中用YOUR_TARGET_URL表示。# 设置环境变量或直接替换 export API_KEYYOUR_API_KEY curl -sS \ -X GET \ -H X-API-Key: $API_KEY \ https://v1.apizero.cn/api/douyin-user?urlYOUR_TARGET_URL | jq .提示使用jq工具可以格式化 JSON 输出。如果没有安装可去掉| jq .。示例输出成功{ code: 0, data: { aweme_count: 123, follower_count: 9999, nickname: 张三, total_favorited: 100000 }, msg: 成功 }示例输出失败 — URL 无效{ code: -1, msg: url 不合法请检查后重试, data: null }返回值解读接口返回的 JSON 顶层包含三个字段字段类型说明codeint状态码0表示成功其他值表示失败msgstring状态描述信息dataobject/null用户数据对象失败时为nulldata 对象字段字段类型说明nicknamestring用户昵称avatarstring用户头像 URL可能为空signaturestring用户简介/签名可能为空aweme_countint作品发布总数follower_countint粉丝数量following_countint关注数量total_favoritedint获赞总数注意实际返回字段以接口文档为准上述字段为常见字段示例。接口可能返回更多字段如cover_thumb、user_id等建议在调用时对未知字段做宽容处理。常见错误排查1.code: -1且msg: url 不合法原因传入的url参数不是有效的抖音用户主页链接。解决检查链接是否为v.douyin.com或douyin.com/user/开头并注意链接是否被截断。可以尝试直接复制浏览器地址栏的链接。2.code: -1且msg: API Key 无效原因X-API-KeyHeader 未传递或 Key 不正确。解决确认 Key 是否正确且没有在请求中漏传 Header。建议使用环境变量管理 Key避免硬编码。3. HTTP 429 Too Many Requests原因QPS 超过 5 次/秒。解决在代码中加入重试或延时逻辑确保每秒请求不超过 5 次。严禁在无限制的 for 循环中连续调用。4.code为其他负值或data为 null原因可能是接口内部错误或用户不存在。解决检查msg字段的描述若持续出现请联系接口技术支持。工程化注意事项API Key 安全切勿将 API Key 硬编码在客户端代码或公开仓库中。建议通过环境变量或密钥管理服务注入。QPS 控制如果你的业务需要批量查询例如每天扫描上千个用户必须实现流量控制。推荐使用令牌桶算法或简单的时间间隔队列。URL 编码url参数在 curl 中可以直接传入完整链接但如果在 GET 请求中拼接时建议对 URL 进行 URL 编码尤其当链接包含特殊字符时。# 使用 curl 的 --data-urlencode 或手动编码 URL_ENCODED$(python3 -c import urllib.parse; print(urllib.parse.quote(https://v.douyin.com/xxxx/, safe))) curl -X GET https://v1.apizero.cn/api/douyin-user?url$URL_ENCODED -H X-API-Key: $API_KEY错误重试对于网络抖动或限流返回的 HTTP 429建议采用指数退避重试策略如第一次等待 1 秒后重试第二次 2 秒最多 3 次。数据缓存用户公开信息的更新频率通常较低几小时到一天如果不需要实时数据可以在本地缓存 1~6 小时减少 API 调用次数。响应字段兼容接口未来可能新增字段代码中访问字段时应做安全检查如data.follower_count可能不存在或使用防御性解析。环境隔离开发环境使用测试 Key生产环境使用正式 Key并配置不同的 QPS 策略。参考文档接口文档页面https://apizero.cn/aidocs/douyin-user原始 Markdown 文档https://apizero.cn/aidocs/douyin-user/raw.mdAPI 平台主页以实际文档为准本文不提供链接。