Suggest domains
POST/v2/email/suggest/domain
Popular email domains in a country, filtered by what the user has typed after the @. 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.
Request
Responses
- 200
- 401
- 403
- 429
Suggestions.
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
Retry-After
Seconds to wait before retrying.