Detect a typo
POST/v2/email/suggest/typo-domain
Same engine and same normalisation as verification. Send an address (email) or a domain (domain, alias input). A key is required — an API key, or a widgetId sent by the widget from a web page. Limit of 60 requests per minute per IP, plus the key's call limit.
details.detectionMethod gives the source: list (correction reference list), typosquat (known trap domain), algorithm (distance engine, with patterns, transformations and difficulty).
Request
Responses
- 200
- 400
- 401
- 403
- 429
Detection result.
Empty input, input longer than 320 characters, or invalid domain.
Missing or invalid authentication: No authorization header, Invalid or revoked API key, Invalid authorization format.
IP or origin not allowed for the key, or widget anti-abuse check.
Four cases, all with Retry-After:
- per-IP rate limit: plain-text body;
- key call limit (minute, hour, day): JSON,
code: API_KEY_RATE_LIMITED; - key credit cap: JSON,
code: API_KEY_BUDGET_EXCEEDED; - widget anti-abuse: JSON.
Response Headers
Seconds to wait before retrying.