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_profile", "identifier": "+17253100591" }'
service_type ws_profile
WhatsApp 头像解析
查一个号码在 WhatsApp 上有没有头像，取回图片地址，并读出这张头像的画像属性。
使用成本: $0.005 / 次响应方式: 同步实时
POST /api/v1/checkWhatsApp 头像解析在线演示
无需登录，直接试用。
接口约定
一次请求，立即返回
提交一个号码，并用 service_type 选择本产品；认证使用你的 API Key。
复制下面的 curl 命令，只需将示例 API Key 替换为你自己的 Key。
响应
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "ws_profile",
"identifier": "+17253100591",
"registered": true,
"avatar": true,
"avatar_url": "https://pps.whatsapp.net/v/example.jpg",
"category": "individual portrait",
"age": 39,
"gender": "male",
"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 — 头像的图片地址；未设置头像时为空字符串。category· string — 图片是什么：单人头像、合影、游戏形象、卡通形象、风景、宠物或物品。没跑出画像时为 unknown。age· integer — 估计年龄，整数，误差约 3 岁，范围 0-80。估计不出时（例如没判定出性别）不返回该字段。gender· string — male、female 或 unknown。skin_color· string — 描述性的肤色，如 white、east_asian、hispanic。按开放集合处理；判不出时为 unknown。hair_color· string — 描述性的发色，如 black、brown、blond、gray white。按开放集合处理；判不出时为 unknown。
适用场景
在以下场景使用本产品
联系人卡片补全
在客户列表、客服会话或通讯录中补充头像状态与图片地址。先判断是否有头像，再决定是否加载或展示默认图。
CRM 头像回填
把查询到的头像地址写回已有联系人档案，让销售、客服和运营查看同一份更完整的客户资料。
线索资格判断
将号码注册状态、头像状态和图片画像放进人工审核队列，为线索资料完整度提供额外参考。
名单分层
根据注册状态、头像是否存在及画像结果建立分组，帮助团队整理名单并安排后续数据处理。
直接答案
WhatsApp 头像解析 是什么？
WhatsApp 头像解析 返回 该号码在 WhatsApp 上是否有头像，有则一并给出图片地址。使用 service_type ws_profile（选择产品的参数）提交一个 E.164 格式的号码，例如 +17253100591，并在同一次 API 响应的顶层读取人像属性。
能力边界
不会返回哪些内容
- 结果反映平台此刻的状态。头像随时可以新增、更换或删除 —— 业务决策需要最新状态时请重新查询。
- 它不是可达性检测，也不是活跃度检测：有头像并不说明这个账号在用、在线，或者能接收任何内容。
- 检测不会向被查账号发送任何内容；结果也不构成身份认证、归属证明或联系许可。
产品常见问题
WhatsApp 头像解析：常见问题
WhatsApp 头像解析 检测什么？
它对一个标识进行检测，并在同一次同步响应中返回该号码在 WhatsApp 上是否有头像，有则一并给出图片地址。
WhatsApp 头像解析如何计费？
仅在检测完成后扣除余额；检测失败或无法判定的请求不会保留扣费。
需要什么号码格式？
按产品接受的形态提交：WhatsApp 用 E.164 格式的号码，邮箱产品用完整的邮箱。发错形态会在扣费前被拒。
头像结果能说明这个号码可以打通吗？
不是。结果只说明平台此刻是否有头像；它不说明账号是否在用、是否在线，也不代表可以联系对方。联系前的同意与适用规则仍需由你自行遵守。
相关产品
