VerifyMails

API 参考

Base URL: https://www.verifymails.dev。鉴权方式: Authorization: Bearer vm_live_... ?key=vm_live_...

端点

GET/api/v1/verify?email={email}验证单个邮箱地址
GET/api/v1/domain?domain={domain}域名级检查(邮件服务器、服务商)

响应 — /api/v1/verify

{
  "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邮箱/域名格式错误
401API key 缺失或无效
402每日额度已用尽
429触发限速(见 Retry-After)

限速与额度

付费档:邮箱查询 2 次/秒,域名查询 15 次/秒(免费档 1/s 和 3/s)。额度按计:Basic / Premium / Pro 分别为每天 5,000 / 10,000 / 20,000 次。

按套餐返回的字段

上面的示例是 Pro 档的响应。字段只在套餐覆盖对应功能时返回——没有的字段不会出现(不会以 null 占位):

套餐字段
Basicemail, 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