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

Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

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.

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	DEPRECATED — bind an API Key credential to the task with `credentialName` instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change.
`operation`	string	yes	—	One of: domain-search, email-finder, email-verifier, account
`domain`	string	no	—	Domain to search (e.g. example.com). Used by domain-search and email-finder.
`company`	string	no	—	Company name as alternative to domain. Used by domain-search and email-finder.
`firstName`	string	no	—	First name of the person. Used by email-finder (with lastName).
`lastName`	string	no	—	Last name of the person. Used by email-finder (with firstName).
`fullName`	string	no	—	Full name of the person as an alternative to firstName + lastName. Used by email-finder.
`email`	string	no	—	Email address to verify. Used by email-verifier.
`limit`	string	no	—	Max number of email addresses to return for domain-search (default 10, max 100).
`offset`	string	no	—	Number of email addresses to skip for domain-search pagination (default 0).
`name`	string	no	—	Path parameter for the operations whose URL contains {name}.