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