The Hunter API lets you integrate Hunter with your own application, website, or internal tools.

It gives you programmatic access to Hunter’s features, so you can automate workflows and connect Hunter with your existing tools — for tasks such as finding or verifying email addresses and building your own integrations.

For more details, you can visit our API reference guide.

API key authentication

Every request to our API must include a personal API key; otherwise, you’ll get an error.

You can find your personal API keys in your Account, under the API section.

You can create multiple API keys to separate and manage calls for different purposes.

Your API keys are linked to your account, so keep them safe and private. You can create, view, or delete your keys anytime in your dashboard.

👉 For testing, you can use the special key test-api-key. It checks your parameters but always returns a dummy response. This test key works with our three main endpoints: Domain Search, Email Finder, and Email Verifier.

API endpoint descriptions

Through our API, you can fully take advantage of our email finding and verification services while also managing your resources, such as Leads, Companies, and Sequences. The API lets you easily create, read, update, and delete data.

Click the drop-downs below to see details about Hunter's API endpoints.

Main API calls

These are the main endpoints you can use to find companies, find email addresses and contacts, and verify email addresses. The cost associated with each endpoint is detailed below.

Discover

Scope: Returns companies matching a set of criteria.
Documentation: https://hunter.io/api-documentation/v2#discover
Credits cost: Free of charge - Premium filters available on all Data Platform plans and for all-in-one outreach paid plans.
Example:
```
POST https://api.hunter.io/v2/discover?api_key=YOUR-API-KEY
```
* You must also include a request body with at least 1 filter.
👉 Couple with the Domain Search endpoint to find email addresses of found companies

Domain Search

Scope: Find all the email addresses corresponding to a website or company name.
Documentation: https://hunter.io/api-documentation/v2#domain-search
Credits cost: 1 credit per 1 to 10 email addresses returned per domain.

Example:

https://api.hunter.io/v2/domain-search?domain=stripe.com&api_key=YOUR-API-KEY

Multi-Domain Search

Scope: Searches for email addresses across every company matching your filters. It returns one row per matching email address with its professional metadata, but the email address itself stays hidden. Each row includes a reveal_handle that you pass to the reveal endpoint to unlock the actual address.
Documentation: Multi-Domain Search and Multi-Domain Search: reveal
Credits cost: The search itself is free. Revealing costs 1 credit per personal email address, and 1 credit per domain for generic addresses.

Example:

POST https://api.hunter.io/v2/multi-domain-search?location=US&department=executive&api_key=YOUR-API-KEY

Then pass the handles you want from the response in the POST body:

POST https://api.hunter.io/v2/multi-domain-search/reveal?api_key=YOUR-API-KEY

Email Finder

Scope: Find the most likely email address from a domain name, a first name and a last name, or from a LinkedIn handle.
Documentation: https://hunter.io/api-documentation/v2#email-finder
Credits cost: 1 credit per call, charged only if an email is found. If no email is found for a given request, no credit is used.

Example:

GET https://api.hunter.io/v2/email-finder?domain=reddit.com&first_name=Alexis&last_name=Ohanian&api_key=YOUR-API-KEY

Email Verifier

Scope: Verify the deliverability of an email address.
Documentation: https://hunter.io/api-documentation/v2#email-verifier
Credits cost: 0.5 credits per call.

Example:

GET https://api.hunter.io/v2/email-verifier?email=patrick@stripe.com&api_key=YOUR-API-KEY

Email Enrichment

Scope: Find all the contact information associated with an email address, such as a person's name, location and social handles.
Documentation: https://hunter.io/api-documentation/v2#email-enrichment
Credits cost: 0.2 credits per call - charged if all of the following data points are returned:
- Email address
- Full name
- Position

Example:

GET https://api.hunter.io/v2/people/find?email=matt@hunter.io&api_key=YOUR-API-KEY

Company Enrichment

Scope: Find all the information associated with a domain name, such as the industry, the description, or the headquarters' location.
Documentation: https://hunter.io/api-documentation/v2#company-enrichment
Credits cost: 0.2 credits per call - charged if all of the following data points are returned:
- Company name
- Category, description or tags
- Location or country code
- Company size

Example:

GET https://api.hunter.io/v2/companies/find?domain=stripe.com&api_key=YOUR-API-KEY

Combined Enrichment

Scope: Find all the information associated with an email address and its domain name.
Documentation: https://hunter.io/api-documentation/v2#combined-enrichment
Credits cost: 0.2 credits per call - charged only when the response returns all core data points from either the company data set or the email data set, described below.
The company core data points include:
- Company name
- Category, description, or tags
- Location or country code
- Company size
The email core data points include:
- Email address
- Full name
- Position

Example:

GET https://api.hunter.io/v2/combined/find?email=matt@hunter.io&api_key=YOUR-API-KEY

Other API calls

You'll find a summary of the remaining endpoints below. The following endpoints are all free of charge.

For a detailed description, visit our full API documentation.

Discover, Finder & Verifier

The remaining endpoints you can use to assist you in finding companies or emails. All free.

Endpoint	What it does
Discover People	Same filters as Discover, but returns the number of emails found (personal/generic/total per company, plus an aggregate across all matches) instead of company profiles.
Domain Finder	Resolves a company name to its most likely domain(s).
Email Count	Tells you how many emails Hunter has for a domain or company, broken down by type/seniority/department.
Discover saved searches	Save and reuse a Discover filter configuration.

ℹ️ If you're using the Domain Search endpoint with company names, you don't need to call the Domain Finder endpoint separately. Domain Finder is already built into Domain Search, so company names are automatically converted into domains.

Email Sequences

Everything below is free of charge and lives under Email Sequences in the docs — the legacy /v2/campaigns path still works everywhere, and mirrors /v2/sequences.

Capability	What it does
List sequences	Returns your sequences, newest first. Available at both `/v2/campaigns` and `/v2/sequences`.
Recipients	Add recipients (by email or lead ID, up to 50 at a time), list a sequence's recipients, or cancel scheduled emails to specific recipients.
Start a sequence	Moves a draft sequence into sending, once it has recipients and content set.
Pause / Resume	Immediately stop or restart scheduled sending on an active sequence.
Archive	Stops a started sequence for good (only works on started sequences).
Create / Update / Delete a draft	Full lifecycle management under `/v2/sequences`: set name, sender accounts, schedule, tracking, AI assistant, BCC.
Follow-ups	List, get, add, and update individual follow-up steps (subject, body, wait days, format). Only the last step can be deleted; updates are blocked while the sequence is active.
Sequence stats	Aggregate + per-follow-up delivery and engagement stats.
Templates	Reusable email templates — can pre-fill a sequence follow-up's subject, body, and format.
Messages	Sent (and optionally incoming) messages with delivery/engagement state — filterable by status, lead, sequence, account, and date.
Send an email	Sends a single email to a lead through one of your connected email accounts, outside of any sequence.
Email Accounts	Your connected sending accounts, plus sub-endpoints for a deliverability health report, sending usage/remaining capacity, capacities across all accounts at once, and warmup (inbox protection) status.
Sequences using an email account	Which sequences depend on a given sending account.

Leads management

Endpoint	What it does
Leads	Create, read, update, upsert, and delete leads.
Lead tags	Create tags and attach/detach them from individual leads.
Lead enrichment	Fills empty lead fields in place from Hunter's data (never overwrites fields you set manually).
Custom Attributes	Define custom fields you can set on leads.
Leads Lists	Create and manage lists of leads.
Leads list folders	Organize leads lists into folders.
Leads list favorites	Pin a leads list to the sidebar in the web app.
Bulk lead operations	Move or delete many leads in a single call.

Companies management

Endpoint	What it does
Companies	Track companies by domain, with rich filters (size, type, industry, technology, funding, location, tags...).
Company Lists	Static (manually curated) or dynamic (saved-filter) lists of companies.
Company list folders	Organize company lists into folders.
Company list favorites	Pin a company list to the sidebar in the web app.
Companies in a company list	Add or remove a company from a static company list.
Company Tags	Create tags and assign/remove them on companies.
Bulk company operations	Move, copy, delete, or tag many companies in a single call.

Account & team

Endpoint	What it does
Account Information	Plan name/level, credits, searches and verifications used vs. available, reset date.
Usage	Returns requests remaining this billing period.
Usage history	Returns a paginated history of your team's past requests
Team members	Lists teammates (id, name, email).

Integrations

Endpoint	What it does
Connected Apps	Lists connected CRMs/tools (HubSpot, Salesforce, Pipedrive, Zoho, Zapier...) and lets you push leads to one.
API keys	List, create, rename, and delete your API keys programmatically.
Webhooks	Full CRUD via API now — previously app-only. See the Webhooks section further down.

API credit usage for All-in-one outreach plans

When using the API, requests are counted as follows:

Domain Search endpoint: 1 credit per 1–10 emails per domain
Multi-Domain Search: free to search. Revealing costs 1 credit per personal email address, or 1 credit per domain for generic addresses.
Email Finder endpoint: 1 credit per email found
Email Verifier endpoint: 0.5 credits per verification
Enrichment API: 0.2 credits per enrichment

Rate limits

When using our API, we ask that you follow our rate limits, which are as follows:

The Domain Search, Email Finder and all Enrichment API calls are rate limited to 15 requests per second / 500 per minute.
The Email Verifier API call is rate limited to 10 requests per second / 300 requests per minute.
The Discover API call is rate limited to 5 requests per second / 50 requests per minute.
The Email Count API call is rate limited to 15 requests per second.

API calls in bulk

Most endpoints work with one piece of data at a time (1 contact, 1 domain, 1 email). If you need to cover many domains at once, use Multi-Domain Search to search across every company matching your filters in a single request, then reveal the addresses you want in batches of up to 100 handles.

Webhooks

Hunter supports the Webhooks integration: you can configure it to apply to all your sequences by default, or create a webhook linked to one specific sequence only. This feature is not available on Data Plans.

Webhooks are notifications about various events that occur for emails you have sent in Hunter Sequences. You can use these notifications to integrate Hunter Sequences with other applications.

To learn more about Webhooks integration, visit this help article.

👉 Find a complete guide to Hunter's API in this dedicated section

API Documentation