AvatarLookup 如何检测账号头像

完成一次检测

这一节讲实时产品：网页后台与 REST 同步接口使用同一套检测服务和响应含义。整份名单走异步批量，见文末。

1. 1

   选择来源

   service_type=ws_avatar 收手机号；service_type=email_avatar 收邮箱地址，一款覆盖 Gmail、Yandex、Mail.ru 三家。

2. 2

   提交一个标识

   一次一个，或通过同步多号接口一次最多 100 个。整批共用同一个 service_type。

3. 3

   读三个字段

   registered、avatar、avatar_url。需要最新状态时重新查询 —— 头像是会变的。

提交什么格式的标识

每款产品只接受一种标识形态，发错形态会在扣费前被拒。

• WhatsApp：一个 E.164 格式的手机号 —— 加号、国家码，然后是用户号码，中间不带空格或分隔符。
• 邮箱：一个完整地址。只接受 Gmail、Yandex、Mail.ru 域名；其他域名在扣费前就被拒绝，因为没有任何上游覆盖它们。
• 不接受带前导零、空格、横线或括号的国内格式。格式被拒不等于「没有头像」。

三个字段各代表什么

它们回答三个不同的问题，不能合成一个。账号不存在自然不可能有头像，但账号存在也可能没有公开头像 —— 这是两个不同的结果，计费相同。

• registered —— 该标识在对应平台上是否有账号。
• avatar —— 这个账号是否公开了照片。为 false 是一个结果，不是失败。
• avatar_url —— avatar 为 true 时给出图片地址，否则是空字符串。它指向平台自己的 CDN，可能按他们的规则失效，所以请把它当作指针而不是存档。
• provider —— 只有邮箱产品返回：该地址归到了三家中的哪一家。它由域名推出，因此恒有值。

结果的使用边界

检测结果反映请求时的状态。它不是身份认证，也不是联系许可。

• 有头像不能确认账号归属于谁、是否在用，也不能确认有人在看。
• 头像随时会被新增、更换、删除。上个月存下的结果只是那一刻的记录，不代表今天。
• 检测不会向被查账号发送任何内容 —— 查询读的是平台本来就公开的内容。

整份名单：异步批量选项

实时多号接口覆盖多数名单。超出之后，把整份文件作为一个异步批量任务提交 —— 这也是触达那些没有实时产品的平台（Telegram、Viber、LINE、MAX）的唯一方式。

• 在批量检测页或通过 API 上传 .txt / .csv，一行一个标识。
• 手机号类产品需要在上传时选定国家；用户名与邮箱类产品不需要。
• 提交时按有效行数冻结余额，只对实际返回结果的标识计费，差额自动退回。
• 任务在后台执行，完成后下载结果压缩包；失败则全额退款。