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.
Features
API Calls:
API Resources:
API endpoint description
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.
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
Custom Attributes API
Custom Attributes API
Scope: Interact with your campaigns programmatically.
Documentation: https://hunter.io/api-documentation/v2#custom-attributes
Campaigns API
Campaigns API
Scope: Interact with your campaigns programmatically.
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.
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: