service_type email_avatar
查一个邮箱账号有没有公开头像，并读出它的画像属性。覆盖 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_avatar", "identifier": "alex.kim@gmail.com" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "email_avatar",
"identifier": "alex.kim@gmail.com",
"registered": true,
"avatar": true,
"avatar_url": "https://lh3.googleusercontent.com/a/example",
"provider": "gmail",
"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，可能按他们的规则失效。请把它当作指针：需要留存就自行下载或缓存。
检测内容
registered · boolean — 该服务商下是否存在这个账号。avatar · boolean — 是否设置了公开头像。avatar_url · string — 公开头像的图片地址；未设置头像时为空字符串。provider · string — 按域名判断出的邮箱服务商：gmail、yandex 或 mailru。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.适用场景
直接答案
邮箱头像画像 返回 该账号是否有公开头像，有则一并给出图片地址。使用 service_type email_avatar（选择产品的参数）提交一个邮箱地址，例如 alex.kim@gmail.com，并在同一次 API 响应里读取 extra 对象。
能力边界
产品常见问题
它对一个标识进行检测，并在同一次同步响应中返回该账号是否有公开头像，有则一并给出图片地址。
仅在检测完成后扣除余额；检测失败或无法判定的请求不会保留扣费。
按产品接受的形态提交：WhatsApp 用 E.164 格式的手机号，邮箱产品用完整的邮箱地址。发错形态会在扣费前被拒。
不是。结果只说明平台此刻是否公开了头像；它不说明账号是否在用、是否在线，也不代表可以联系对方。联系前的同意与适用规则仍需由你自行遵守。
相关产品