Name: Hunter – B2B Email Finder & Verifier | Free · $9/mo | API.market
Brand: hunter-api
SKU: api-hunter-api-email-api
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

Shashank Agarwal

## Hunter Email API Documentation

The **Hunter Email API** is a powerful tool designed for developers who need to automate tasks such as email address discovery, verification, and management. It’s an essential API for building applications related to email marketing, lead generation, and outreach automation. With features like domain search, email verification, and email counting, this API allows you to build efficient workflows for collecting and validating email addresses, ensuring higher deliverability and improved campaign results.

### Key Features of the Hunter Email API:

- **Domain Search API**: Retrieve all publicly available email addresses associated with any given domain. Ideal for identifying key contacts within an organization.
- **Email Finder API**: Find specific email addresses by providing first name, last name, and domain. This helps ensure you are reaching the right individual in a target company.
- **Email Verifier API**: Check the validity and deliverability of an email address, reducing bounce rates and improving the success of email campaigns.
- **Email Count API**: Get a detailed count of both personal and generic emails associated with a domain, categorized by department and seniority levels.

### Why Use Hunter Email API?

1. **Boost Lead Generation**: The Domain Search API helps you discover all available emails for a given domain, making it easier to compile a targeted contact list.
2. **Reduce Bounce Rates**: The Email Verifier API ensures that the emails you send are deliverable, improving the quality of your email list and preventing bounces.
3. **Target the Right Contacts**: The Email Finder API allows you to find specific contacts at a company, ensuring that your outreach is highly relevant.
4. **Gain Detailed Insights**: The Email Count API provides a breakdown of emails by department and seniority, allowing you to focus on key decision-makers within an organization.

### Use Cases

- **Email Marketing Automation**: Integrate the Hunter API with your email marketing tool to automate lead generation, email verification, and contact discovery.
- **Sales Outreach**: Build custom sales workflows that allow your team to identify key contacts within target companies and verify their email addresses before sending a campaign.
- **Lead Enrichment**: Enrich your CRM or sales database with verified email addresses, ensuring the accuracy and relevance of your lead data.
- **Data-Driven Insights**: Use the Email Count API to understand the distribution of emails across departments and seniority, helping you target your outreach effectively.

By leveraging the **Hunter Email API**, developers can enhance their email-related applications with tools that ensure accuracy, relevance, and deliverability, making it a valuable asset for any organization focused on efficient email outreach.

---

### Authentication

All API endpoints require an API key, which must be passed in the header as `x-magicapi-key`.

```bash
-H 'x-magicapi-key: <your-api-key>'
```

---

## API Endpoints Overview

1. [Domain Search API](#domain-search-api)
2. [Email Finder API](#email-finder-api)
3. [Email Verifier API](#email-verifier-api)
4. [Email Count API](#email-count-api)

---

### Domain Search API

The **Domain Search API** allows you to retrieve email addresses associated with a domain. It returns publicly available email addresses, along with additional information such as the individual’s name, position, and confidence score.

**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/domain-search?domain=example.com' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Parameters:**
- **domain** (string, required): The domain name to search.
- **limit** (integer, optional): Limit the number of emails returned per request (default: 10).
- **offset** (integer, optional): Pagination offset.

**Sample Response:**

```json
{
  "data": {
    "domain": "example.com",
    "emails": [
      {
        "value": "contact@example.com",
        "confidence": 95,
        "first_name": "John",
        "last_name": "Doe",
        "position": "CEO",
        "department": "Management",
        "verification": {
          "status": "valid"
        }
      }
    ],
    "organization": "Example Inc.",
    "headcount": "100-200",
    "industry": "Technology"
  },
  "meta": {
    "results": 1,
    "limit": 10,
    "offset": 0
  }
}
```

---

### Email Finder API

The **Email Finder API** allows you to find a specific individual’s email address using their first name, last name, and domain.

**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/email-finder?domain=example.com&first_name=John&last_name=Doe' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Parameters:**
- **first_name** (string, required): The individual’s first name.
- **last_name** (string, required): The individual’s last name.
- **domain** (string, required): The domain of the organization.

**Sample Response:**

```json
{
  "data": {
    "email": "john.doe@example.com",
    "confidence": 96,
    "sources": [
      {
        "domain": "linkedin.com",
        "url": "https://www.linkedin.com/in/johndoe",
        "extracted_on": "2024-10-01"
      }
    ]
  }
}
```

#### Additional Example:
**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/email-finder?domain=reddit.com&first_name=Alexis&last_name=Ohanian' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Sample Response:**

```json
{
  "data": {
    "first_name": "Alexis",
    "last_name": "Ohanian",
    "email": "alexis@reddit.com",
    "score": 87,
    "domain": "reddit.com",
    "position": "Designer",
    "company": "Reddit",
    "sources": [
      {
        "domain": "reddit.blogspot.com",
        "uri": "http://reddit.blogspot.com/2007/10",
        "extracted_on": "2018-11-02",
        "last_seen_on": "2024-10-15",
        "still_on_page": true
      }
    ],
    "verification": {
      "date": "2024-10-22",
      "status": "accept_all"
    }
  }
}
```

---

### Email Verifier API

The **Email Verifier API** checks the deliverability of an email address, ensuring that it is valid and reducing the likelihood of bounce rates.

**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/email-verifier?email=john.doe%40example.com' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Parameters:**
- **email** (string, required): The email address to verify.

**Sample Response:**

```json
{
  "data": {
    "email": "john.doe@example.com",
    "result": "deliverable",
    "score": 95,
    "verification": {
      "mx_records": true,
      "smtp_check": true,
      "accept_all": false,
      "disposable": false,
      "webmail": false
    }
  }
}
```

#### Additional Example:
**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/email-verifier?email=patrick%40stripe.com' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Sample Response:**

```json
{
  "data": {
    "status": "accept_all",
    "result": "risky",
    "score": 80,
    "email": "patrick@stripe.com",
    "mx_records": true,
    "smtp_check": true,
    "accept_all": true,
    "sources": [
      {
        "domain": "icloudnewz.blogspot.com",
        "uri": "http://icloudnewz.blogspot.com/2018/01/follow-nathan-hubbard-josh-elman-and.html",
        "extracted_on": "2019-11-30",
        "last_seen_on": "2024-10-15",
        "still_on_page": true
      }
    ]
  }
}
```

---

### Email Count API

The **Email Count API** provides a breakdown of the total number of personal and generic email addresses associated with a domain. It also categorizes the email addresses by department and seniority levels.

**Request:**

```bash
curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/hunter-api/email-api/email-count?domain=stripe.com' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: <your-api-key>'
```

**Parameters:**
- **domain** (string, required): The domain for which to count email addresses.

**Sample Response:**

```json
{
  "data": {
    "total": 294,
    "personal_emails": 143,
    "generic_emails": 151,
    "department": {
      "executive": 3,
      "it": 8,
      "finance": 5,
      "management": 6,
      "sales": 10,
      "legal": 5,
      "support": 38,
      "hr": 0,
      "marketing": 0,
      "communication": 10,
      "education": 1,
      "design": 2,
      "operations": 2
    },
    "seniority": {
      "junior": 0,
      "senior": 10,
      "executive": 7
    }
  },
  "meta": {
    "params": {
      "domain": "stripe.com"
    }
  }
}
```



Find and verify business emails by domain, automating B2B lead generation. Free 20 calls/mo, from $9/mo. Start free on API.market.

Hunter – B2B Email Finder & Verifier | Free · $9/mo | API.market

Free

hunter-api

START

GROW

Ultra

Really good API for finding emails from any website.