Find and verify professional email addresses by domain via the Hunter.io API. Supports domain search, email finder, email verification, and account info.

Hunter

Find and verify professional email addresses by domain using the Hunter.io API v2.

This InTouch tool wraps four core Hunter.io endpoints behind a single operation switch. It uses the Python standard library only (no external packages) and returns the raw Hunter JSON payload as a string, plus the HTTP status code.

Base URL: https://api.hunter.io/v2
Auth: API key passed as the api_key query parameter (single key authenticates every call — no OAuth, no token exchange).

Operations

`operation`	Hunter endpoint	What it does	Key inputs
`domain-search`	`GET /v2/domain-search`	Returns all email addresses found for a domain or company, with confidence scores and metadata.	`domain` or `company`; optional `limit` (default 10, max 100), `offset`
`email-finder`	`GET /v2/email-finder`	Finds the most likely email address for a named person at a domain/company.	(`domain` or `company`) and (`fullName` or `firstName` + `lastName`)
`email-verifier`	`GET /v2/email-verifier`	Verifies the deliverability of a single email address.	`email`
`account`	`GET /v2/account`	Returns your account info and request quota. Free call, no credits used.	none (just `apiKey`)

Inputs

Input	Required	Used by	Description
`apiKey`	yes	all	Your Hunter.io API key.
`operation`	yes	all	One of: `domain-search`, `email-finder`, `email-verifier`, `account`.
`domain`	conditional	domain-search, email-finder	Domain to search, e.g. `intercom.io`.
`company`	conditional	domain-search, email-finder	Company name, as an alternative to `domain`.
`firstName`	conditional	email-finder	Person's first name (with `lastName`).
`lastName`	conditional	email-finder	Person's last name (with `firstName`).
`fullName`	conditional	email-finder	Person's full name, as an alternative to `firstName` + `lastName`.
`email`	conditional	email-verifier	Email address to verify.
`limit`	no	domain-search	Max emails to return (default 10, max 100).
`offset`	no	domain-search	Emails to skip for pagination (default 0).

Outputs

Output	Description
`result`	The Hunter.io JSON response, as a JSON string.
`status`	The HTTP status code as a string (`200` on success; `4xx`/`5xx` carry a JSON error body in `result`).

API key setup

Sign in at hunter.io and open the API page in your dashboard.
Copy your API key.
Pass it as the apiKey input. (For automated jobs, store it in an InTouch runtime environment variable and reference it from the job rather than hard-coding it.)

Examples

Domain search — all emails at intercom.io, first 25:

operation = domain-search
domain    = intercom.io
limit     = 25

Email finder — best email for a named person:

operation = email-finder
domain    = reddit.com
firstName = Alexis
lastName  = Ohanian

Email verifier — check a single address:

operation = email-verifier
email     = [email protected]

Account — check your remaining quota (free):

operation = account

Notes

The email-verifier endpoint can run up to ~20 seconds; the step timeout is 60s to stay within Hunter's limits.
Non-2xx responses are returned (not thrown): status carries the code and result carries Hunter's JSON error body, so callers can branch on it.
Response bodies are capped at ~5 MB.