EmailCheckPro

API 文档

实时邮箱验证 API：一个邮箱地址，一次请求，同一次响应返回

核心是单号实时检测：向 /api/v1/check 提交一个邮箱地址并带上 service_type=email。注册状态在同一次响应里返回，不需要轮询，也不需要回调。同一个 API Key 还能一次提交多个邮箱地址，同步返回结果。

获取 API Key查看快速接入
API 接口POST
/api/v1/check
X-API-Key 请求头code · msg · data
最后更新：2026 年 8 月 31 日service_type=email读取 data.registered
API 速览主接口是单号实时检测；多号、异步批量和余额接口共用同一份 API Key 约定，并统一使用 code / msg / data 响应结构。

快速接入

  1. 1.在设置中创建 API Key。
  2. 2.通过 GET /api/v1/balance 查询当前余额。
  3. 3.向 /api/v1/check 提交一个邮箱地址，或向 /api/v1/batch-check 一次提交最多 100 个。
  4. 4.读取同步响应中的 data.registered。

认证

使用在设置中创建的 API Key，并随每次请求一起发送。

X-API-Key: sk_your_api_key
妥善保管你的 API Key
请始终从你的服务端发起请求；持有该 Key 的任何人都可以消耗你的账户余额。

产品与返回字段

email邮箱注册检测确认一个邮箱地址是否在其服务商处注册 —— 任何域名都适用，从 Gmail 到企业自建域名。email_avatar邮箱头像检测在注册状态之外，返回公开头像。支持 Gmail、Yandex、Mail.ru。
email

邮箱注册检测

确认一个邮箱地址是否在其服务商处注册 —— 任何域名都适用，从 Gmail 到企业自建域名。

01

单号检测

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", "identifier": "name@gmail.com" }'
已注册
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "identifier": "name@gmail.com",
    "registered": true,
    "provider": "gmail"
  }
}
未注册
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "identifier": "unknown@gmail.com",
    "registered": false,
    "provider": ""
  }
}
registeredboolean该地址在邮箱服务商处是否存在账号。
providerstring按域名判定的服务商：gmail、outlook、yahoo、icloud、yandex、mailru 或 other。
02

多号检测

计费：按邮箱地址计算

请求中的每个邮箱地址独立计费，单次最多提交 100 个邮箱地址。只有成功完成检测的邮箱地址才会消耗余额。如果余额不足以覆盖整批邮箱地址的最高可能费用，请求会在处理前直接拒绝。

一次请求最多提交 100 个邮箱地址，结果按提交顺序返回。

curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifiers": ["name@gmail.com", "unknown@gmail.com"] }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "total": 2,
    "succeeded": 1,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true,
        "provider": "gmail"
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": false
      }
    ]
  }
}
existsboolean该邮箱地址是否得到了结果。为 false 表示邮箱地址格式错误、结果无法判定或本次检测失败；为 false 时，以下字段均不出现。
registeredboolean该邮箱地址是否已注册。仅当 exists 为 true 时出现，含义与单号检测一致。
providerstring按域名判定的服务商：gmail、outlook、yahoo、icloud、yandex、mailru 或 other。

并发、超时与重试方式

邮箱注册检测采用同步响应，请根据返回码决定接收结果或稍后重试。

  • 每个用户最多 5 个请求在处理单号检测与多号检测共用这个上限，一次多号请求算一个请求，与邮箱地址数量无关。此外每个账号同时只能跑 1 个多号检测，第二个会被拒绝直到前一个结束。达到任一上限都会立即返回业务码 42901 并附带 Retry-After 响应头，不扣费，等已有请求结束后再提交即可。
  • 单号 60 秒，多号 300 秒超过后返回业务码 50400，不计费；多号超时是整批失败，不返回部分结果，已扣费用全额退回。
  • 多号单次最多 100 个邮箱地址结果按提交顺序、同等长度返回。每个账号同时只跑 1 个多号检测，上一批返回后再提交下一批。

错误码

40000不支持的 service_type 或字段冲突
40001JSON 请求体无效
40002邮箱地址无效
40100缺少或无效的 API Key
40200余额不足
42200暂时无法判定该邮箱地址。不返回 data，且本次不计费
42900次数配额已用完，或未完成订单数超限
429015 个在处理的请求名额已满，或该账号已有一个多号检测在跑；已有请求结束后可再次提交，拒绝请求不扣余额，响应带 Retry-After
50303平台此刻处理中的检测已达上限，不扣费；按 Retry-After 的秒数等待后重新提交同一请求
50400本次检测未在超时预算内完成，不计费，可直接重试；批量超时为整批失败并全额退款
50300检测服务维护中

异步批量任务

上传邮箱地址文件，立刻拿到任务号；之后按任务号查询状态。任务成功后，查询响应里会带上结果文件的下载链接；偶尔会暂缺，稍后再查一次即可。整套接口只有这两个动作。它面向大批量名单；100 个以内的邮箱地址用多号接口一次请求就能拿到结果。邮箱批量任务不需要传 country，文件每行一个邮箱地址。

  • email_avatar_batch邮箱批量头像检测每个任务 1,000–100,000 个邮箱地址$0.003 / 邮箱地址

1. 提交文件

curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt
响应：任务已创建（status 为 processing）
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "processing",
    "total": 1000,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. 查询任务

curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
响应：任务已完成（成功时带 result_url）
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "success",
    "total": 1000,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.zip",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
  • 一行一个邮箱地址。上传 .txt 或 .csv，一行一个邮箱地址；邮箱任务没有国家这一项。全量注册检测一份文件里可以混放任意域名。头像检测覆盖 Gmail、Yandex、Mail.ru 三家，一份文件里三家可以混着传，每个地址会分派到对应的服务商；这三家之外的地址会在扣费之前被拒绝，错误信息里会给出条数。
  • 不提供逐号进度。status 只有 processing、success、failed 三种。大名单需要一段时间，轮询不要快于 30 秒一次。
  • 计费方式。提交时按整份文件冻结。任务结束后只对真正检测到结果的邮箱地址收费，其余退回；任务失败则全额退款。
  • 结果文件有时效。下载链接是按需生成的，指向一个有时效的文件，请在任务完成后尽快下载。

准备好开始接入了吗？

准备好了吗？免费注册即可在几秒内获取 API Key。

创建免费账号