cURL 请求
POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "ws_avatar", "identifier": "+14155552671" }'
service_type ws_avatar
WhatsApp 头像画像
查一个手机号在 WhatsApp 上有没有公开头像，取回图片地址，并读出这张头像的画像属性。
使用成本: $0.004 / 次响应方式: 同步实时
POST /api/v1/checkWhatsApp 头像画像公开演示
无需登录；公开演示有每日次数限制。
接口约定
一次请求，立即返回
提交一个手机号，并用 service_type 选择本产品；认证使用你的 API Key。
复制下面的 curl 命令，只需将示例 API Key 替换为你自己的 Key。
响应
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "ws_avatar",
"identifier": "+14155552671",
"registered": true,
"avatar": true,
"avatar_url": "https://pps.whatsapp.net/v/example.jpg",
"extra": {
"profile_available": "true",
"category": "individual portrait",
"gender": "male",
"age": "39",
"skin_color": "white",
"hair_color": "brown"
}
}
}正确使用结果
让一次单号检测真正有用的三个细节
提交一个完整的标识
WhatsApp 用 E.164 格式的手机号（加号、国家码、号码），邮箱产品用完整的邮箱地址。
读三个字段，不是一个
registered 说明账号是否存在，avatar 说明是否公开了头像，avatar_url 给出图片地址。每一次成功查询三个都会返回。
图片自行抓取
avatar_url 指向平台自己的 CDN，可能按他们的规则失效。请把它当作指针：需要留存就自行下载或缓存。
检测内容
WhatsApp 头像画像 会返回什么？
返回字段
registered· boolean — 该手机号是否注册了 WhatsApp。avatar· boolean — 是否设置了公开头像。avatar_url· string — 公开头像的图片地址；未设置头像时为空字符串。extra.profile_available· boolean — Whether portrait attributes were produced this time. Read it together with avatar: false/false means there is no avatar to analyse, true/false means the avatar could not be recognized.extra.category· string — What the picture is: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar or object.extra.gender· string — male, female or unknown.extra.age· number — Estimated age, accurate to about 3 years and clamped to 0-80. Empty when no gender was determined — there is no placeholder number.extra.skin_color· string — Descriptive skin tone, for example white, east_asian or hispanic. Treat it as an open set.extra.hair_color· string — Descriptive hair colour, for example black, brown, blond or gray white. Treat it as an open set.
适用场景
在以下场景使用本产品
- 联系人卡片补全
- CRM 头像回填
- 线索资格判断
- 名单分层
直接答案
WhatsApp 头像 是什么？
WhatsApp 头像画像 返回 该号码在 WhatsApp 上是否有公开头像，有则一并给出图片地址。使用 service_type ws_avatar（选择产品的参数）提交一个 E.164 格式的手机号，例如 +14155552671，并在同一次 API 响应里读取 extra 对象。
能力边界
不会返回哪些内容
- 结果反映平台此刻公开了什么。头像随时可以新增、更换或删除 —— 业务决策需要最新状态时请重新查询。
- 它不是可达性检测，也不是活跃度检测：有头像并不说明这个账号在用、在线，或者能接收任何内容。
- 检测不会向被查账号发送任何内容；结果也不构成身份认证、归属证明或联系许可。
产品常见问题
关于WhatsApp 头像的常见问题
WhatsApp 头像画像 检测什么？
它对一个标识进行检测，并在同一次同步响应中返回该号码在 WhatsApp 上是否有公开头像，有则一并给出图片地址。
WhatsApp 头像如何计费？
仅在检测完成后扣除余额；检测失败或无法判定的请求不会保留扣费。
需要什么手机号格式？
按产品接受的形态提交：WhatsApp 用 E.164 格式的手机号，邮箱产品用完整的邮箱地址。发错形态会在扣费前被拒。
头像结果能说明这个号码可以打通吗？
不是。结果只说明平台此刻是否公开了头像；它不说明账号是否在用、是否在线，也不代表可以联系对方。联系前的同意与适用规则仍需由你自行遵守。
相关产品