VerifyMails

APIリファレンス

Base URL: https://www.verifymails.dev。認証方法: Authorization: Bearer vm_live_... または ?key=vm_live_...

エンドポイント

GET/api/v1/verify?email={email}メールアドレスを1件検証
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キーがないか無効
4021日の上限に到達
429レート制限超過(Retry-After参照)

レート制限とクォータ

有料プラン:メールアドレス 2リクエスト/秒、ドメイン 15リクエスト/秒(無料プランは1/sと3/s)。クォータは日次:Basic / Premium / Proでそれぞれ1日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