用途:给一个种子抖音账号(账号名或抖音号),返回一批定位相似的对标账号,用于竞品发现、对标选号与账号矩阵布局。
主要能力:调用都爆鸭相似账号推荐接口,返回 currentAccount(种子账号信息)与相似账号列表(items[] 或 similarAccounts),条目含 accountName、followerCount、similarity。可选 --sync 先对种子号发起作品同步(douyin-sync-notes),提升推荐质量。
使用方式:先到 doubaoya.com 登录,在口令中心生成形如 dyh_… 的密钥,设入环境变量:export DOUBAOYA_API_KEY="dyh_你的口令"。再运行脚本:python3 scripts/find_similar.py "账号名或抖音号";种子号数据稀疏时可加 --sync。推荐接口为 POST https://doubaoya.com/api/apis/douyin/douyin-similar-account/call,请求体 {"accountName":"<账号名或抖音号>"},认证头 Authorization: Bearer $DOUBAOYA_API_KEY。
限制:种子号必须真实存在,否则无对标列表;--sync 为异步只回执任务,约 30 分钟入库、不计费,脚本不阻塞不轮询,需稍后去掉 --sync 重跑。返回需先判断 success,失败按错误码处理(401 密钥问题、400 入参错误、402 额度不足、502 上游失败已退款可重试)。只呈现接口真实字段,缺失标“暂无”,不编造相似度、粉丝量或播放率、完播率等本接口无返回的指标。