service_type email_avatar

邮箱头像检测

在注册状态之外,返回公开头像。支持 Gmail、Yandex、Mail.ru。

使用成本: $0.003 / 次响应方式: 同步实时POST /api/v1/check
邮箱头像检测
公开演示

无需登录;公开演示有每日次数限制。

接口约定

一次请求,立即返回

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

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

cURL 请求POST /api/v1/check
curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifier": "name@gmail.com" }'
响应200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "identifier": "name@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a-/example",
    "provider": "gmail"
  }
}

正确使用结果

让一次单号检测真正有用的三个细节

  1. 提交一个完整的邮箱地址

    用户名、@ 和域名要一起提交,例如 name@example.com。域名决定这次检测走哪条线路。

  2. 读取 registered

    SaaS 网页后台与同步 API 使用相同的响应结构,返回邮箱注册状态。

  3. 使用同步返回结果

    成功响应会同步返回 registered;需要更新状态时请重新检测,联系用户前仍需取得相应同意。

检测内容

邮箱头像检测 会返回什么?

返回字段

  • registered · boolean该服务商下是否存在这个账号。
  • avatar · boolean是否设置了公开头像。
  • avatar_url · string设置了头像时的头像 URL。
  • provider · string这个地址判到了哪一家:gmail、yandex 或 mailru。

适用场景

在以下场景使用本产品

  • 联系人补全
  • 资料完整度
  • 风控审核
  • CRM 数据治理

覆盖范围

头像检测 接受哪些地址

该产品只检测 Gmail / Yandex / Mail.ru 邮箱。其它域名的地址会在扣费前被拒绝 —— 那些请用注册检测。

  • Gmailgmail.com · googlemail.com
  • Yandexyandex.ru · yandex.com · ya.ru · yandex.by · yandex.kz · yandex.ua · narod.ru · yandex.com.tr
  • Mail.rumail.ru · inbox.ru · list.ru · bk.ru · internet.ru · xmail.ru

直接答案

头像检测 是什么?

邮箱头像检测 用于返回注册状态、是否设置了公开头像、头像 URL,以及这个地址归到了三家中的哪一家。调用时把 service_type(选择检测产品的参数)设为 email_avatar,提交一个完整的邮箱地址(例如 name@example.com),即可在同一次响应中读取 registered。

能力边界

不会返回哪些内容

  • 不会返回邮件内容、文件夹、联系人或任何私密账号内容。
  • 这款实时产品不会返回在线状态、最后上线时间或活跃情况;需要这些字段请用异步批量的活跃度检测。
  • 只返回 tg 响应中定义的注册状态字段。

产品常见问题

关于头像检测的常见问题

邮箱头像检测 检测什么?

它对一个邮箱地址进行检测,并在同一次同步响应中返回注册状态、是否设置了公开头像、头像 URL,以及这个地址归到了三家中的哪一家。

头像检测如何计费?

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

需要什么邮箱地址格式?

提交一个邮箱地址,例如 name@example.com。由域名决定这次检测走哪家服务商。

显示已注册,是否代表获得了联系许可?

不是。结果仅反映检测时的邮箱注册状态;同意、接收方偏好和适用的平台规则仍需由你自行遵守。

相关产品

按需选择检测产品

立即开始检测

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