You can integrate Hunter with your own application, website, or internal tools using our API.
The API lets you access Hunter’s features programmatically, automate workflows, and connect Hunter with your existing tools. You can use it for tasks such as finding or verifying email addresses and building integrations for your own processes.
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.
Your personal API keys can be found 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
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
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
Email Finder
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
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
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
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
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
Discover, Finder & Verifier
The remaining endpoints you can use to assist you in finding companies or emails. All free.
Endpoint | What it does |
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. | |
Resolves a company name to its most likely domain(s). | |
Tells you how many emails Hunter has for a domain or company, broken down by type/seniority/department. | |
Save and reuse a Discover filter configuration. |
Email Sequences
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 |
Returns your sequences, newest first. Available at both | |
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. | |
Moves a draft sequence into sending, once it has recipients and content set. | |
Immediately stop or restart scheduled sending on an active sequence. | |
Stops a started sequence for good (only works on started sequences). | |
Full lifecycle management under | |
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. | |
Aggregate + per-follow-up delivery and engagement stats. | |
Reusable email templates — can pre-fill a sequence follow-up's subject, body, and format. | |
Sent (and optionally incoming) messages with delivery/engagement state — filterable by status, lead, sequence, account, and date. | |
Sends a single email to a lead through one of your connected email accounts, outside of any sequence. | |
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. | |
Which sequences depend on a given sending account. |
Leads management
Leads management
Endpoint | What it does |
Create, read, update, upsert, and delete leads. | |
Create tags and attach/detach them from individual leads. | |
Fills empty lead fields in place from Hunter's data (never overwrites fields you set manually). | |
Define custom fields you can set on leads. | |
Create and manage lists of leads. | |
Organize leads lists into folders. | |
Pin a leads list to the sidebar in the web app. | |
Move or delete many leads in a single call. |
Companies management
Companies management
Endpoint | What it does |
Track companies by domain, with rich filters (size, type, industry, technology, funding, location, tags...). | |
Static (manually curated) or dynamic (saved-filter) lists of companies. | |
Organize company lists into folders. | |
Pin a company list to the sidebar in the web app. | |
Add or remove a company from a static company list. | |
Create tags and assign/remove them on companies. | |
Move, copy, delete, or tag many companies in a single call. |
Account & team
Account & team
Endpoint | What it does |
Plan name/level, credits, searches and verifications used vs. available, reset date. | |
Returns requests remaining this billing period. | |
Returns a paginated history of your team's past requests | |
Lists teammates (id, name, email). |
Integrations
Integrations
Endpoint | What it does |
Lists connected CRMs/tools (HubSpot, Salesforce, Pipedrive, Zoho, Zapier...) and lets you push leads to one. | |
List, create, rename, and delete your API keys programmatically. | |
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
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 and Email Finder API calls are both rate-limited to 15 requests per second / 500 per minute (per API key or IP).
The Email Verifier API call is rate-limited to 10 requests per second / 300 requests per minute (per API key or IP).
API calls in bulk
Each API call needs to be performed with one piece of data at a time (1 contact, 1 domain, 1 email, etc.). We don't currently offer "bulk" API calls.
Webhooks
Hunter supports the Webhooks integration, which can be configured to be added to all your email sequences by default, or you can create a webhook linked to a specific email 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. These notifications can be used 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