邮箱地址检测

API

综合性邮箱质量评估接口，一次请求完成 6 项检测： ① RFC 5322 格式校验 ② 临时/一次性邮箱检测（基于 72,345 条开源域名库，3 个数据源合并去重） ③ MX 记录验证（用 AliDNS DoH，避开 PHP getmxrr 不稳定） ④ 拼写纠正（gmial.…

文档

由极数本源提供·更新于昨天

288

累计调用

72ms

平均响应

98.16%

服务可用性

500 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 10

今日已用 0 / 500 次/日0.0%

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 100 次 · QPS 3

登录免费

当前方案

每日 500 次 · QPS 10

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/email-check/raw.md

接口请求地址

https://v1.apizero.cn/api/email-check

接口请求方式

GET

请求参数格式

QUERY STRING

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/email-check?email=email

接口信息备注

匿名 QPS=3、日 100 次；登录后 QPS=10、日 500 次。

请求参数说明

名称	类型	说明
email	string	必填 · 要检测的邮箱地址，最长 254 字符（RFC 上限）

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

返回字段说明

名称	类型	说明
email	string	小写规范化后的邮箱
input	string	原始输入回显
valid_format	boolean	是否符合 RFC 5322 格式
local	string	本地部分（@ 前面，格式无效时为 null）
domain	string	域名部分（@ 后面，格式无效时为 null）
is_disposable	boolean	是否临时/一次性邮箱
disposable_match	string\|null	匹配上的具体临时邮箱域名（可能是上级域名）
is_trusted	boolean	是否知名邮箱服务商
provider	string\|null	服务商中文名（如「QQ 邮箱」「Gmail」）
has_mx	boolean	域名是否配置了 MX 记录
mx_records	array	MX 记录列表（按 priority 升序）
mx_records[].priority	integer	优先级（数字越小越优先）
mx_records[].exchange	string	邮件服务器主机名
mx_records[].ttl	integer	TTL 秒
spelling_suggestion	string\|null	拼写错误建议（疑似拼错知名域名时返回，如 "gmial.com" → "gmail.com"）
risk_score	integer	★ 综合风险评分 0~100（越高越可信）
risk_level	string	风险等级：invalid / high / medium / low
reasons	string[]	判定原因列表（含 ✅/⚠️ 前缀）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "email": "test@gmial.com",
    "input": "test@gmial.com",
    "valid_format": true,
    "local": "test",
    "domain": "gmial.com",
    "is_disposable": false,
    "disposable_match": null,
    "is_trusted": false,
    "provider": null,
    "has_mx": false,
    "mx_records": [],
    "spelling_suggestion": "gmail.com",
    "risk_score": 5,
    "risk_level": "invalid",
    "reasons": [
      "⚠️ 域名无 MX 记录，无法接收邮件",
      "⚠️ 域名疑似拼写错误，建议用 gmail.com",
      "⚠️ 本地部分含测试/系统类关键词"
    ]
  },
  "request_id": "mota...",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

string

必填 · 要检测的邮箱地址，最长 254 字符（RFC 上限）

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

名称

类型

说明

string

小写规范化后的邮箱

input

string

原始输入回显

valid_format

boolean

是否符合 RFC 5322 格式

local

string

本地部分（@ 前面，格式无效时为 null）

domain

string

域名部分（@ 后面，格式无效时为 null）

is_disposable

boolean

是否临时/一次性邮箱

disposable_match

string|null

匹配上的具体临时邮箱域名（可能是上级域名）

is_trusted

boolean

是否知名邮箱服务商

provider

string|null

服务商中文名（如「QQ 邮箱」「Gmail」）

has_mx

boolean

域名是否配置了 MX 记录

mx_records

array

MX 记录列表（按 priority 升序）

mx_records[].priority

integer

优先级（数字越小越优先）

mx_records[].exchange

string

邮件服务器主机名

mx_records[].ttl

integer

TTL 秒

spelling_suggestion

string|null

拼写错误建议（疑似拼错知名域名时返回，如 "gmial.com" → "gmail.com"）

risk_score

integer

★ 综合风险评分 0~100（越高越可信）

risk_level

string

风险等级：invalid / high / medium / low

reasons

string[]

判定原因列表（含 ✅/⚠️ 前缀）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "email": "test@gmial.com", "input": "test@gmial.com", "valid_format": true, "local": "test", "domain": "gmial.com", "is_disposable": false, "disposable_match": null, "is_trusted": false, "provider": null, "has_mx": false, "mx_records": [], "spelling_suggestion": "gmail.com", "risk_score": 5, "risk_level": "invalid", "reasons": [ "⚠️ 域名无 MX 记录，无法接收邮件", "⚠️ 域名疑似拼写错误，建议用 gmail.com", "⚠️ 本地部分含测试/系统类关键词" ] }, "request_id": "mota...", "tips": "极数本源 · https://apizero.cn" }