从零开始：抖音用户公开信息API的请求与响应解析

适用场景抖音用户公开信息API适用于需要基于用户主页链接快速获取其公开基础数据的场景。典型的应用包括内容运营检测批量分析达人账号的粉丝规模、作品总数、获赞总量辅助判断账号活跃程度。社交关系分析采集关注与粉丝数据绘制账号影响力图谱。自动化数据报表定时拉取指定账号的公开指标生成趋势看板。链接有效性验证自动展开短链并检查用户主页是否可访问。该接口聚焦于单用户维度的轻量数据不适用于需要用户授权、私密数据或深度关系链的场景。接口能力边界输入与输出输入一条合法的抖音用户主页链接支持v.douyin.com短链与douyin.com/user/长链。输出JSON 格式内嵌code、msg以及data对象data中包含以下字段nickname用户昵称字符串avatar用户头像URL字符串signature个人签名字符串aweme_count作品总数整数follower_count粉丝数整数following_count关注数整数total_favorited获赞总数整数注意以上字段均为用户公开信息非私有或登录态数据。接口不提供用户UID、手机号、私信记录等敏感信息。速率限制接口QPS上限为 5 次/秒。在并发请求时建议控制频率避免触发限流返回429 Too Many Requests。实际可用限额以文档最新说明为准。鉴权与请求参数鉴权方式采用请求头Header鉴权通过X-API-Key传入你的API密钥。密钥需要提前在API平台获取并妥善保管。Header 名称X-API-KeyHeader 值你的API Key字符串Query参数参数名是否必填类型描述url是string抖音用户主页链接支持短链与长链参数说明短链示例https://v.douyin.com/xxxxx/长链示例https://www.douyin.com/user/xxxxx接口会自动解析短链至目标长链无需手动展开。url值需要经过 URL 编码如空格转%20大部分HTTP库会自动处理。完整请求示例curlcurl -sS \ -X GET \ -H X-API-Key: YOUR_API_KEY \ https://v1.apizero.cn/api/douyin-user?urlhttps%3A%2F%2Fv.douyin.com%2Fabc123%2F说明将YOUR_API_KEY替换为实际密钥。使用-sS保持静默但保留错误输出。如果url参数包含特殊字符如/、?务必进行 URL 编码或直接使用工具自带编码功能。代码接入示例Pythonimport requests API_KEY your_api_key_here url https://v1.apizero.cn/api/douyin-user params {url: https://v.douyin.com/abc123/} headers {X-API-Key: API_KEY} try: resp requests.get(url, paramsparams, headersheaders, timeout10) resp.raise_for_status() data resp.json() if data[code] 0: user data[data] print(f昵称: {user[nickname]}) print(f粉丝: {user[follower_count]}) print(f作品: {user[aweme_count]}) print(f获赞: {user[total_favorited]}) else: print(f业务错误: {data[msg]}) except requests.exceptions.RequestException as e: print(f请求失败: {e})返回值解读成功响应HTTP 200{ code: 0, msg: 成功, data: { nickname: 张三, avatar: https://p3-pc.douyinpic.com/..., signature: 记录生活, aweme_count: 123, follower_count: 9999, following_count: 88, total_favorited: 100000 } }字段含义code0 表示请求成功非0表示业务异常见下文错误处理。msg与code对应的描述信息。data核心数据对象包含七个字段均为公开信息。注意部分字段如signature、avatar可能为空字符串或 null建议在代码中做判空处理。aweme_count、follower_count等数值字段保证为整数。错误返回示例{ code: 1001, msg: 参数错误url不能为空, data: null }{ code: 1002, msg: 获取用户信息失败请检查链接是否正确, data: null }{ code: 1003, msg: API Key 无效或已过期, data: null }常见错误与排查错误表现可能原因解决措施HTTP 401 / 403API Key 未传或错误检查X-API-Key是否拼写正确密钥是否有效。HTTP 429请求频率超过 5 QPS降低并发数增加重试退避逻辑。code: 1001url参数为空或格式无效确认链接包含douyin.com或v.douyin.com。code: 1002抖音用户不存在或链接过期验证链接能否在浏览器正常访问。code: 1003API Key 被禁用或余额不足检查API平台账户状态。返回数据中字段为null用户未设置签名/头像等代码中增加if user[signature]判空。响应字符串非JSON网络代理或中间件篡改查看原始响应体排除代理干扰。工程化注意事项缓存策略用户公开信息变化频率较低如粉丝数可能每日更新建议缓存至少5分钟避免频繁请求导致限流。异常重试对于网络抖动或 5xx 错误采用指数退避重试如1秒、2秒、4秒。对 4xx 错误不重试直接记录日志。URL 编码url参数中的特殊字符务必编码推荐使用urllib.parse.quotePython或encodeURIComponentJavaScript。超时设置设置合理超时如 10 秒避免接口挂起耗尽连接池。日志记录记录每次请求的url、HTTP 状态码、code、msg以及响应耗时便于排查问题。数据校验即使code为 0也要验证data结构是否完整防止接口升级导致字段缺失。参考文档抖音用户公开信息 API 官方文档https://apizero.cn/aidocs/douyin-user原始 Markdown 文档https://apizero.cn/aidocs/douyin-user/raw.md