✓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 키 누락 또는 무효
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