# Hunter

> Find and verify professional email addresses for your prospecting and outreach workflows.

App · Contact Management · 5 actions. Web page: https://docs.lodol.com/docs/integrations/hunter

## Actions

### Domain search

Find the email addresses associated with a company domain, with each contact's name, role, and confidence score.

**Inputs**

- Domain (`domain`, text): The company website domain to search, e.g. 'stripe.com'. Provide this or Company name.
- Company name (`company`, text): The company name to search, e.g. 'Stripe'. Used when Domain is not provided.
- Max results (`limit`, number): Optional. Number of email addresses to return, from 1 to 100. Defaults to 10. From 1 to 100.
- Offset (`offset`, number): Optional. Number of results to skip, for paging through large domains. At least 0.
- Email type (`email_type`, text): Optional. Restrict results to 'personal' or 'generic' addresses. One of: `personal`, `generic`.
- Seniority (`seniority`, text): Optional. Filter contacts by seniority. Comma-separate to combine, e.g. 'senior,executive'.
- Department (`department`, text): Optional. Filter contacts by department, e.g. 'sales' or 'executive,it'. Comma-separate to combine.

**Outputs**

- `accept_all` (true/false): Whether the mail server accepts all addresses
- `disposable` (true/false): Whether the domain is a disposable-email provider
- `domain` (text): The domain the results are for
- `emails` (list): Contacts found on this page
- `organization` (text): Company name Hunter has for the domain
- `pattern` (text): The company's email pattern, e.g. '{first}.{last}'
- `total_results` (number): Total contacts Hunter has for the domain, across all pages
- `webmail` (true/false): Whether the domain is a free webmail provider

**Example output**

```json
{
  "accept_all": false,
  "disposable": false,
  "domain": "stripe.com",
  "emails": [
    {
      "confidence": 99,
      "department": "executive",
      "first_name": "Patrick",
      "last_name": "Collison",
      "linkedin": "patrickcollison",
      "phone_number": "",
      "position": "CEO",
      "seniority": "executive",
      "twitter": "patrickc",
      "type": "personal",
      "value": "patrick@stripe.com",
      "verification": {
        "date": "2026-04-12",
        "status": "valid"
      }
    }
  ],
  "organization": "Stripe",
  "pattern": "{first}",
  "total_results": 142,
  "webmail": false
}
```

### Email count

Count how many email addresses Hunter has for a domain or company, split by personal and generic. Free and uses no credits.

**Inputs**

- Domain (`domain`, text): The company website domain, e.g. 'stripe.com'. Provide this or Company name.
- Company name (`company`, text): The company name, e.g. 'Stripe'. Used when Domain is not provided.
- Email type (`email_type`, text): Optional. Restrict the count to 'personal' or 'generic' addresses. One of: `personal`, `generic`.

**Outputs**

- `generic_emails` (number): How many are generic addresses (e.g. info@)
- `personal_emails` (number): How many are personal addresses
- `total` (number): Total email addresses Hunter has

**Example output**

```json
{
  "generic_emails": 14,
  "personal_emails": 128,
  "total": 142
}
```

### Email finder

Find the most likely email address for a specific person at a company, from their name and the company's domain.

**Inputs**

- Domain (`domain`, text): The company website domain, e.g. 'stripe.com'. Provide this or Company name.
- Company name (`company`, text): The company name, e.g. 'Stripe'. Used when Domain is not provided.
- First name (`first_name`, text): The person's first name. Provide with Last name, or use Full name instead.
- Last name (`last_name`, text): The person's last name. Provide with First name, or use Full name instead.
- Full name (`full_name`, text): The person's full name. Use instead of First and Last name.

**Outputs**

- `accept_all` (true/false): Whether the server accepts all addresses
- `company` (text): Company name, if known
- `domain` (text): Company domain
- `email` (text): The email address found, or empty if none
- `first_name` (text): First name
- `last_name` (text): Last name
- `linkedin_url` (text): LinkedIn profile URL, if known
- `phone_number` (text): Phone number, if known
- `position` (text): Job title, if known
- `score` (number): Confidence the address is correct, 0 to 100
- `twitter` (text): Twitter/X handle, if known
- `verification` (object): Verification of the found address, if any

**Example output**

```json
{
  "accept_all": false,
  "company": "Stripe",
  "domain": "stripe.com",
  "email": "patrick@stripe.com",
  "first_name": "Patrick",
  "last_name": "Collison",
  "linkedin_url": "https://linkedin.com/in/patrickcollison",
  "phone_number": "",
  "position": "CEO",
  "score": 99,
  "twitter": "patrickc",
  "verification": {
    "date": "2026-04-12",
    "status": "valid"
  }
}
```

### Email verifier

Check whether an email address is deliverable, returning its status and the individual checks Hunter ran.

**Inputs**

- Email address (`email`, text, required): The email address to verify.

**Outputs**

- `accept_all` (true/false): Whether the server accepts all addresses
- `block` (true/false): Whether the server blocked verification
- `disposable` (true/false): Whether it's from a disposable-email provider
- `email` (text): The address that was verified
- `gibberish` (true/false): Whether the local part looks random
- `mx_records` (true/false): Whether the domain has mail (MX) records
- `regexp` (true/false): Whether the address has a valid format
- `score` (number): Deliverability confidence, 0 to 100
- `smtp_check` (true/false): Whether the mailbox itself was accepted
- `smtp_server` (true/false): Whether the mail server is reachable
- `status` (text): Overall result: 'valid', 'invalid', 'accept_all', 'webmail', 'disposable', or 'unknown'
- `webmail` (true/false): Whether it's from a free webmail provider

**Example output**

```json
{
  "accept_all": false,
  "block": false,
  "disposable": false,
  "email": "patrick@stripe.com",
  "gibberish": false,
  "mx_records": true,
  "regexp": true,
  "score": 99,
  "smtp_check": true,
  "smtp_server": true,
  "status": "valid",
  "webmail": false
}
```

### Get account information

Get the connected Hunter account's plan and how many searches and verifications remain this period.

**Inputs**: None.

**Outputs**

- `email` (text): The account's email address
- `plan_name` (text): The account's plan, e.g. 'Free' or 'Growth'
- `reset_date` (text): When the monthly quota resets (YYYY-MM-DD)
- `searches` (object): Search requests used and available
- `verifications` (object): Verification requests used and available

**Example output**

```json
{
  "email": "you@example.com",
  "plan_name": "Growth",
  "reset_date": "2026-08-11",
  "searches": {
    "available": 10000,
    "used": 500
  },
  "verifications": {
    "available": 20000,
    "used": 100
  }
}
```