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": "email_profile", "identifier": "alex.kim@gmail.com" }'
service_type email_profile
查一个邮箱账号有没有头像,并读出它的画像属性。覆盖 Gmail、Yandex、Mail.ru。
POST /api/v1/check
邮箱头像解析无需登录,直接试用。
接口约定
提交一个邮箱,并用 service_type 选择本产品;认证使用你的 API Key。
复制下面的 curl 命令,只需将示例 API Key 替换为你自己的 Key。
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": "email_profile", "identifier": "alex.kim@gmail.com" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "email_profile",
"identifier": "alex.kim@gmail.com",
"registered": true,
"avatar": true,
"avatar_url": "https://lh3.googleusercontent.com/a/example",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}使用方式
WhatsApp 用 E.164 格式的号码(加号、国家码、号码),邮箱产品用完整的邮箱。
registered 说明账号是否存在(邮箱则表示是否可达),avatar 说明是否有头像,avatar_url 给出图片地址。每一次成功查询三个都会返回。
avatar_url 指向平台自己的 CDN,可能按他们的规则失效。请把它当作指针:需要留存就自行下载或缓存。
检测内容
registered · boolean — 该邮箱是否可达(能否收到邮件)。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。适用场景
为邮箱联系人补充头像状态和图片地址,让客户列表与沟通记录更易辨认。
统一处理 Gmail、Yandex 和 Mail.ru 地址,把头像信息回写到现有客户档案。
在整理邮箱名单时区分账号存在、是否设置头像和结果是否完整,为资料补全与人工复核提供依据。
识别没有头像、未得到明确结果或服务商不在支持范围内的记录,让客户资料保持一致。
直接答案
邮箱头像解析 返回 该账号是否有头像,有则一并给出图片地址。使用 service_type email_profile(选择产品的参数)提交一个邮箱,例如 alex.kim@gmail.com,并在同一次 API 响应的顶层读取人像属性。
能力边界
产品常见问题
它对一个标识进行检测,并在同一次同步响应中返回该账号是否有头像,有则一并给出图片地址。
仅在检测完成后扣除余额;检测失败或无法判定的请求不会保留扣费。
按产品接受的形态提交:WhatsApp 用 E.164 格式的号码,邮箱产品用完整的邮箱。发错形态会在扣费前被拒。
不是。结果只说明平台此刻是否有头像;它不说明账号是否在用、是否在线,也不代表可以联系对方。联系前的同意与适用规则仍需由你自行遵守。
相关产品