Skip to main content

Hunter API for Data Plans

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. 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

Account Information API

Discover 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

  • 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 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 Count 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 - charged if all of the following data points are returned:

    • Email address

    • Full name

    • Position

  • Example: 

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

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 - charged if all of the following data points are returned:

    • Company name

    • Category, description or tags

    • Location or country code

    • Company size

  • Example: 

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

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 - - 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 includes:

    • Company name

    • Category, description, or tags

    • Location or country code

    • Company size

    The email core data points includes:

    • Email address

    • Full name

    • Position

  • Example: 

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

Resources

Leads API

Scope: Save and manage your leads in Hunter.

Documentation: https://hunter.io/api-documentation/v2#leads

Lead Lists API

Scope: Save and manage leads lists in Hunter.

Documentation: https://hunter.io/api-documentation/v2#leads-lists

API Credit usage for Data plans

When using the API, requests are counted as follows for Data Plans:

  • Domain Search endpoint: 1 Search credit per 1–10 emails per domain

  • Email Finder endpoint: 1 Search credit per email found

  • Email Verifier endpoint: 1 Verification credit per verification

  • Enrichment API: 1 Search credit per enrichment

  • Discover API: free of cost

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.

FAQs

Can I use Hunter in a third-party application?

Yes, you can embed Hunter data into your own product or SaaS application. This is a supported use case.

The only restriction is that your product shouldn't replicate Hunter's core features (such as our Email Finder, Domain Search and Email Verifer) as a standalone offering. As long as Hunter data is used as part of a broader product rather than to rebuild what Hunter itself does, you're good to go.

For the full details, refer to Hunter's Terms of Service.

Do I have access to the Hunter platform on a Data Plan?

Yes, you get access to the Hunter platform, but with some limitations compared to an All-in-one outreach plan.

The following features are not included on a Data Platform plan:

  • Sequences — Hunter's built-in cold email outreach tool, which lets you automate follow-up emails and track replies directly from Hunter.

  • Discover — Hunter's company prospecting tool, which lets you search and filter companies by criteria like industry, size, and location to build targeted lead lists.

  • Signals — Real-time buying intent data that surfaces companies showing signs of being in-market, based on triggers like hiring activity and web traffic changes.

Everything else available on a standard All-in-one outreach plan — Domain Search, Email Finder, Email Verifier, Leads, and Enrichment — is fully accessible.

Can I share my API key across multiple applications or services?

Yes, your API key can be used across as many applications or services as you need. You can find your key in the API section of your Hunter account.

If you have team members added to your Team, each member will have their own individual API key. This means you can track credit usage per team member, though it won't tell you which specific application or service the credits were used on.

What happens to my API access if I run out of credits mid-month?

Once your credits are exhausted, API calls will return a 429 error — "You have reached your usage limit."

If you need to access further credits, you can simply purchase additional credits by subscribing to a new Data Platform plan from our pricing page.

Is there an enterprise option if I need higher rate limits or a volume deal?

If you need more than 1 million Search or Verification credits, you can contact our sales team to discuss a custom plan tailored to your needs.

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

API Reference Guide

Related Articles
Hunter API
Hunter All-in-One Outreach plans
What is Hunter?
What’s included in Hunter’s Free Plan?
How to verify emails via API (with code examples)
Did this answer your question?