You can integrate Hunter with your service or create custom connections using our API functionality.
To get started with the API, you can have a look at your API overview page, where you will also find your secret API key needed to perform any API Calls.
API Key Authentication
Every request to our API must include your API key — otherwise, you’ll get an error.
To get started with the API, you can have a look at your API overview page, where you will also find your secret API key needed to perform any API Calls.
Your API key is linked to your account, so keep it 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.
Features
API Calls:
API Resources:
API endpoint descriptions
Through our API, you can fully take advantage of our email finding and verifying services while also managing your resources like Leads and Campaigns. The API lets you easily create, read, update, and delete data.
💡 If you're on a Data Platform plan, you can refer to the available API endpoints here.
👉 Click the drop-downs below to see details about each API endpoint in Hunter:
API Calls
API Calls
Account Information API
Account Information API
Scope: Get information regarding your Hunter account.
Documentation: https://hunter.io/api-documentation/v2#account
Credits cost: This call is free of charge.
Example:
https://api.hunter.io/v2/account?api_key=YOUR-API-KEY
Discover API
Discover API
Scope: Returns companies matching a set of criteria. (Not available on Data Plans)
Documentation: https://hunter.io/api-documentation/v2#discover
Credits cost: Free of charge - Premium filters available on a paid standard plan.
Example:
https://api.hunter.io/v2/discover?api_key=YOUR-API-KEY
Domain Search API
Domain Search API
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 for 1 to 10 email addresses per domain returned.
Example:
https://api.hunter.io/v2/domain-search?domain=stripe.com&api_key=YOUR-API-KEY
Email Finder API
Email Finder API
Scope: Find the most likely email address from a domain name, a first name and a last name.
Documentation: https://hunter.io/api-documentation/v2#email-finder
Credits cost: 1 credit per call. Returns a verified email.
Example:
https://api.hunter.io/v2/email-finder?domain=reddit.com&first_name=Alexis&last_name=Ohanian&api_key=YOUR-API-KEY
Email Verifier API
Email Verifier API
Scope: Verify the deliverability of an email address.
Documentation: https://hunter.io/api-documentation/v2#email-verifier
Credits cost: 0.5 credit per call.
Example:
https://api.hunter.io/v2/email-verifier?email=patrick@stripe.com&api_key=YOUR-API-KEY
Email Count API
Email Count API
Scope: Know how many email addresses we have for a domain or a company.
Documentation: https://hunter.io/api-documentation/v2#email-count
Credits cost: This call is free of charge.
Example:
https://api.hunter.io/v2/email-count?domain=stripe.com
Email Enrichment API
Email Enrichment API
Scope: Find all the 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: 1 credit per call.
Example:
https://api.hunter.io/v2/people/find?email=matt@hunter.io&api_key=YOUR-API-KEY
Company Enrichment API
Company Enrichment API
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 credit per call.
Example:
https://api.hunter.io/v2/companies/find?domain=stripe.com&api_key=YOUR-API-KEY
Combined Enrichment API
Combined Enrichment API
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 credit per call.
Example:
https://api.hunter.io/v2/combined/find?email=matt@hunter.io&api_key=YOUR-API-KEY
Resources
Resources
Leads API
Leads API
Scope: Save and manage your leads in Hunter.
Documentation: https://hunter.io/api-documentation/v2#leads
Lead Lists API
Lead Lists API
Scope: Save and manage leads lists in Hunter.
Documentation: https://hunter.io/api-documentation/v2#leads-lists
Custom Attributes API
Custom Attributes API
Scope: Interact with your campaigns programmatically. (Not available on Data Plans)
Documentation: https://hunter.io/api-documentation/v2#custom-attributes
Campaigns API
Campaigns API
Scope: Interact with your campaigns programmatically. (Not available on Data Plans)
Documentation: https://hunter.io/api-documentation/v2#campaigns
Request usage
When using the API, requests are counted in the same way as on the website, and the same pricing is applied.
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 campaigns by default, or you can create a webhook linked to a specific campaign only. This feature is not available on Data Plans.
Webhooks are notifications about various events that occur for emails you have sent in Hunter Campaigns. These notifications can be used to integrate Hunter Campaigns with other applications.
👉 To learn more about this integration, visit this Help Article.
💡 Find a complete guide to Hunter's API in this dedicated section: