Base URL: https://www.verifymails.dev。鉴权方式: Authorization: Bearer vm_live_... 或 ?key=vm_live_...
/api/v1/verify?email={email}验证单个邮箱地址/api/v1/domain?domain={domain}域名级检查(邮件服务器、服务商){
"email": "[email protected]",
"domain": "gmail.com",
"disposable": false, // disposable / temporary email
"block": false, // recommended to block (disposable or high risk)
"deliverable_email": true, // domain can receive mail
"mx": true,
"mx_host": ["gmail-smtp-in.l.google.com", "..."],
"mx_priority": { "gmail-smtp-in.l.google.com": 5 },
"email_provider": "Gmail",
"privacy": false, // alias / privacy relay / forwarding
"privacy_provider": null,
"apple_hide_my_email": false,
"catch_all": null, // true / false / null (not probed yet)
"risk_score": 0, // 0-100
"canonical": "[email protected]", // normalized (dots / +tag removed)
"is_variant": true,
"plus_tag": "tag",
"domain_age_days": 10759,
"authentication": { "spf": {...}, "dmarc": {...} },
"signals": [...]
}| 状态码 | 含义 |
|---|---|
| 400 | 邮箱/域名格式错误 |
| 401 | API key 缺失或无效 |
| 402 | 每日额度已用尽 |
| 429 | 触发限速(见 Retry-After) |
付费档:邮箱查询 2 次/秒,域名查询 15 次/秒(免费档 1/s 和 3/s)。额度按日计:Basic / Premium / Pro 分别为每天 5,000 / 10,000 / 20,000 次。
上面的示例是 Pro 档的响应。字段只在套餐覆盖对应功能时返回——没有的字段不会出现(不会以 null 占位):
| 套餐 | 字段 |
|---|---|
| Basic | email, domain, disposable, block, risk_score |
| Premium | + privacy, privacy_provider, mx, mx_host, mx_priority, authentication, domain_age_days, signals, related_domains (domain endpoint) |
| Pro | + email_provider, provider_category, apple_hide_my_email, canonical, is_variant, plus_tag, catch_all, deliverable_email |