You can integrate Hunter with your service or create custom connections using our API functionality.
The API endpoints and credit usage differ for users on a Data Plan. Therefore, this dedicated article has been created. If you are on a Standard Plan instead, please refer to this article here.
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 standard 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
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 Search 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 Search 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: 1 Verification 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 Search 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: 1 Search 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: 1 Search 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
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.
💡 Find a complete guide to Hunter's API in this dedicated section: