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 |