service_type email_profile

邮箱头像解析

查一个邮箱账号有没有头像,并读出它的画像属性。覆盖 Gmail、Yandex、Mail.ru。

使用成本: $0.005 / 次响应方式: 同步实时POST /api/v1/check
邮箱头像解析
在线演示

无需登录,直接试用。

接口约定

一次请求,立即返回

提交一个邮箱,并用 service_type 选择本产品;认证使用你的 API Key。

复制下面的 curl 命令,只需将示例 API Key 替换为你自己的 Key。

cURL 请求POST /api/v1/check
curl -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"
  }
}

使用方式

一次实时检测的三个步骤

  1. 提交一个完整的标识

    WhatsApp 用 E.164 格式的号码(加号、国家码、号码),邮箱产品用完整的邮箱。

  2. 读三个字段,不是一个

    registered 说明账号是否存在(邮箱则表示是否可达),avatar 说明是否有头像,avatar_url 给出图片地址。每一次成功查询三个都会返回。

  3. 图片自行抓取

    avatar_url 指向平台自己的 CDN,可能按他们的规则失效。请把它当作指针:需要留存就自行下载或缓存。

检测内容

邮箱头像解析 会返回什么?

返回字段

  • registered · boolean该邮箱是否可达(能否收到邮件)。
  • avatar · boolean是否设置了头像。
  • avatar_url · string头像的图片地址;未设置头像时为空字符串。
  • category · string图片是什么:单人头像、合影、游戏形象、卡通形象、风景、宠物或物品。没跑出画像时为 unknown。
  • age · integer估计年龄,整数,误差约 3 岁,范围 0-80。估计不出时(例如没判定出性别)不返回该字段。
  • gender · stringmale、female 或 unknown。
  • skin_color · string描述性的肤色,如 white、east_asian、hispanic。按开放集合处理;判不出时为 unknown。
  • hair_color · string描述性的发色,如 black、brown、blond、gray white。按开放集合处理;判不出时为 unknown。

适用场景

在以下场景使用本产品

  • 联系人卡片补全

    为邮箱联系人补充头像状态和图片地址,让客户列表与沟通记录更易辨认。

  • CRM 头像回填

    统一处理 Gmail、Yandex 和 Mail.ru 地址,把头像信息回写到现有客户档案。

  • 邮件名单梳理

    在整理邮箱名单时区分账号存在、是否设置头像和结果是否完整,为资料补全与人工复核提供依据。

  • 账号数据清理

    识别没有头像、未得到明确结果或服务商不在支持范围内的记录,让客户资料保持一致。

直接答案

邮箱头像解析 是什么?

邮箱头像解析 返回 该账号是否有头像,有则一并给出图片地址。使用 service_type email_profile(选择产品的参数)提交一个邮箱,例如 alex.kim@gmail.com,并在同一次 API 响应的顶层读取人像属性。

能力边界

不会返回哪些内容

  • 结果反映平台此刻的状态。头像随时可以新增、更换或删除 —— 业务决策需要最新状态时请重新查询。
  • 它不是可达性检测,也不是活跃度检测:有头像并不说明这个账号在用、在线,或者能接收任何内容。
  • 检测不会向被查账号发送任何内容;结果也不构成身份认证、归属证明或联系许可。

产品常见问题

邮箱头像解析:常见问题

邮箱头像解析 检测什么?

它对一个标识进行检测,并在同一次同步响应中返回该账号是否有头像,有则一并给出图片地址。

邮箱头像解析如何计费?

仅在检测完成后扣除余额;检测失败或无法判定的请求不会保留扣费。

需要什么号码格式?

按产品接受的形态提交:WhatsApp 用 E.164 格式的号码,邮箱产品用完整的邮箱。发错形态会在扣费前被拒。

头像结果能说明这个号码可以打通吗?

不是。结果只说明平台此刻是否有头像;它不说明账号是否在用、是否在线,也不代表可以联系对方。联系前的同意与适用规则仍需由你自行遵守。

相关产品

其他头像解析产品

立即开始检测

创建账号后,可通过 SaaS 网页后台或 API 使用全部检测产品:同步实时检测与异步批量检测共用同一份余额。