用途:批量诊断一个或多个抖音账号,输入账号名(中文名)或抖音号均可,混传亦可,返回账号画像、粉丝量、健康度及基于真实字段的运营建议,适合账号矩阵盘点、代运营交付、竞品对标与自查。
主要能力:脚本 scripts/diagnose_account.py 读取环境变量 DOUBAOYA_API_KEY,向诊断接口发起请求,成功时以 JSON 打印 data(含 items[]),常见字段为 accountName、followerCount、healthScore。可选 --sync 先调用作品同步接口 douyin-sync-notes,回执形如 {"status":"syncing","accepted":true,"retryAfterMinutes":30},约 30 分钟入库,不计费,脚本不阻塞、不轮询。
使用方式:先到 doubaoya.com 登录,进入口令中心生成 dyh_ 开头口令,设入环境变量:export DOUBAOYA_API_KEY="dyh_你的口令"。随后运行:python3 scripts/diagnose_account.py "账号名1" "账号名2",首次数据稀疏时加 --sync,等约 30 分钟去掉 --sync 重跑。诊断接口为 POST https://doubaoya.com/api/apis/douyin/douyin-account-diagnosis/call,请求体 { "accountNames": [...] },请求头 Authorization: Bearer $DOUBAOYA_API_KEY。
结果处理:先判断 success 是否为 true;items[] 字段可能缺失,缺失即标暂无。错误码:401 密钥缺失或无效,400 入参有误,402 额度不足需充值,502 上游失败已自动退款可重试;另有 NETWORK_ERROR 与 BAD_RESPONSE。
限制:必须传入真实存在的账号,否则返回空结果;不编造接口未返回的健康度、粉丝量或播放率、完播率等指标;--sync 仅首次同步使用一次;计费为诊断调用本身,充值价格等信息资料未提供;未涉及的平台与字段暂未提供。