# Hunter.io (/integrations/hunter)





{/* MANUAL-CONTENT-START:intro */}

Use [Hunter.io](https://hunter.io/) to find and verify professional emails, search company domains, discover companies, and enrich company information.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Search domains, find email addresses, verify email addresses, discover companies, find companies, and count email addresses.

## Actions [#actions]

### Hunter Discover [#hunter-discover]

Returns companies matching a set of criteria using Hunter.io AI-powered search.

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | string | No | Natural language search query for companies |
| `domain` | string | No | Company domain name to filter by (e.g., "stripe.com", "company.io") |
| `headcount` | string | No | Company size filter (e.g., "1-10", "11-50") |
| `company_type` | string | No | Type of organization |
| `technology` | string | No | Technology used by companies |
| `apiKey` | string | Yes | Hunter.io API Key |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `results` | array | List of companies matching the search criteria |
| ↳ `domain` | string | Company domain |
| ↳ `organization` | string | Organization name |
| ↳ `personal_emails` | number | Count of personal emails |
| ↳ `generic_emails` | number | Count of generic (role-based) emails |
| ↳ `total_emails` | number | Total emails found for the company |

### Hunter Domain Search [#hunter-domain-search]

Returns all the email addresses found using one given domain name, with sources.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `domain` | string | Yes | Domain name to search for email addresses (e.g., "stripe.com", "company.io") |
  | `limit` | number | No | Maximum email addresses to return (e.g., 10, 25, 50). Default: 10 |
  | `offset` | number | No | Number of email addresses to skip for pagination (e.g., 0, 10, 20) |
  | `type` | string | No | Filter for personal or generic emails (e.g., "personal", "generic", "all") |
  | `seniority` | string | No | Filter by seniority level (e.g., "junior", "senior", "executive") |
  | `department` | string | No | Filter by specific department (e.g., "sales", "marketing", "engineering", "hr") |
  | `apiKey` | string | Yes | Hunter.io API Key |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `emails` | array | List of email addresses found for the domain (up to 100 per request) |
  | ↳ `value` | string | The email address |
  | ↳ `type` | string | Email type: personal or generic (role-based) |
  | ↳ `confidence` | number | Probability score (0-100) that the email is correct |
  | ↳ `first_name` | string | Person's first name |
  | ↳ `last_name` | string | Person's last name |
  | ↳ `position` | string | Job title/position |
  | ↳ `position_raw` | string | Raw job title as found |
  | ↳ `seniority` | string | Seniority level (junior, senior, executive) |
  | ↳ `department` | string | Department (executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations) |
  | ↳ `linkedin` | string | LinkedIn profile URL |
  | ↳ `twitter` | string | Twitter handle |
  | ↳ `phone_number` | string | Phone number |
  | ↳ `sources` | array | List of sources where the email was found (limited to 20) |
  | ↳ `domain` | string | Domain where the email was found |
  | ↳ `uri` | string | Full URL of the source page |
  | ↳ `extracted_on` | string | Date when the email was first extracted (YYYY-MM-DD) |
  | ↳ `last_seen_on` | string | Date when the email was last seen (YYYY-MM-DD) |
  | ↳ `still_on_page` | boolean | Whether the email is still present on the source page |
  | ↳ `verification` | object | Email verification information |
  | ↳ `date` | string | Date when the email was verified (YYYY-MM-DD) |
  | ↳ `status` | string | Verification status (valid, invalid, accept\_all, webmail, disposable, unknown) |
  | `domain` | string | The searched domain name |
  | `disposable` | boolean | Whether the domain is a disposable email service |
  | `webmail` | boolean | Whether the domain is a webmail provider (e.g., Gmail) |
  | `accept_all` | boolean | Whether the server accepts all email addresses (may cause false positives) |
  | `pattern` | string | The email pattern used by the organization (e.g., \{first}, \{first}.\{last}) |
  | `organization` | string | The organization/company name |
  | `linked_domains` | array | Other domains linked to the organization |
</ReferenceDetails>

### Hunter Email Finder [#hunter-email-finder]

Finds the most likely email address for a person given their name and company domain.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `domain` | string | Yes | Company domain name (e.g., "stripe.com", "company.io") |
  | `first_name` | string | Yes | Person's first name (e.g., "John", "Sarah") |
  | `last_name` | string | Yes | Person's last name (e.g., "Smith", "Johnson") |
  | `company` | string | No | Company name (e.g., "Stripe", "Acme Inc") |
  | `apiKey` | string | Yes | Hunter.io API Key |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `sources` | array | List of sources where the email was found (limited to 20) |
  | ↳ `domain` | string | Domain where the email was found |
  | ↳ `uri` | string | Full URL of the source page |
  | ↳ `extracted_on` | string | Date when the email was first extracted (YYYY-MM-DD) |
  | ↳ `last_seen_on` | string | Date when the email was last seen (YYYY-MM-DD) |
  | ↳ `still_on_page` | boolean | Whether the email is still present on the source page |
  | `verification` | object | Email verification information |
  | ↳ `date` | string | Date when the email was verified (YYYY-MM-DD) |
  | ↳ `status` | string | Verification status (valid, invalid, accept\_all, webmail, disposable, unknown) |
  | `first_name` | string | Person's first name |
  | `last_name` | string | Person's last name |
  | `email` | string | The found email address |
  | `score` | number | Confidence score (0-100) for the found email address |
  | `domain` | string | Domain that was searched |
  | `accept_all` | boolean | Whether the server accepts all email addresses (may cause false positives) |
  | `position` | string | Job title/position |
  | `twitter` | string | Twitter handle |
  | `linkedin_url` | string | LinkedIn profile URL |
  | `phone_number` | string | Phone number |
  | `company` | string | Company name |
</ReferenceDetails>

### Hunter Email Verifier [#hunter-email-verifier]

Verifies the deliverability of an email address and provides detailed verification status.

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `email` | string | Yes | The email address to verify |
  | `apiKey` | string | Yes | Hunter.io API Key |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `sources` | array | List of sources where the email was found (limited to 20) |
  | ↳ `domain` | string | Domain where the email was found |
  | ↳ `uri` | string | Full URL of the source page |
  | ↳ `extracted_on` | string | Date when the email was first extracted (YYYY-MM-DD) |
  | ↳ `last_seen_on` | string | Date when the email was last seen (YYYY-MM-DD) |
  | ↳ `still_on_page` | boolean | Whether the email is still present on the source page |
  | `result` | string | Deliverability result: deliverable, undeliverable, or risky |
  | `score` | number | Deliverability score (0-100). Webmail and disposable emails receive an arbitrary score of 50. |
  | `email` | string | The verified email address |
  | `regexp` | boolean | Whether the email passes regular expression validation |
  | `gibberish` | boolean | Whether the email appears to be auto-generated (e.g., [e65rc109q@company.com](mailto:e65rc109q@company.com)) |
  | `disposable` | boolean | Whether the email is from a disposable email service |
  | `webmail` | boolean | Whether the email is from a webmail provider (e.g., Gmail) |
  | `mx_records` | boolean | Whether MX records exist for the domain |
  | `smtp_server` | boolean | Whether connection to the SMTP server was successful |
  | `smtp_check` | boolean | Whether the email address doesn't bounce |
  | `accept_all` | boolean | Whether the server accepts all email addresses (may cause false positives) |
  | `block` | boolean | Whether the domain is blocking verification (validity could not be determined) |
  | `status` | string | Verification status: valid, invalid, accept\_all, webmail, disposable, unknown, or blocked |
</ReferenceDetails>

### Hunter Companies Find [#hunter-companies-find]

Enriches company data using domain name.

#### Input [#input-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `domain` | string | Yes | Domain to find company data for (e.g., "stripe.com", "company.io") |
| `apiKey` | string | Yes | Hunter.io API Key |

#### Output [#output-4]

| Parameter | Type | Description |
| - | - | - |
| `name` | string | Company name |
| `domain` | string | Company domain |
| `description` | string | Company description |
| `industry` | string | Industry classification |
| `sector` | string | Business sector |
| `size` | string | Employee headcount range (e.g., "11-50") |
| `founded_year` | number | Year founded |
| `location` | string | Headquarters location (formatted) |
| `country` | string | Country (full name) |
| `country_code` | string | ISO 3166-1 alpha-2 country code |
| `state` | string | State/province |
| `city` | string | City |
| `linkedin` | string | LinkedIn handle (e.g., company/hunterio) |
| `twitter` | string | Twitter handle |
| `facebook` | string | Facebook handle |
| `logo` | string | Company logo URL |
| `phone` | string | Company phone number |
| `tech` | array | Technologies used by the company |

### Hunter Email Count [#hunter-email-count]

Returns the total number of email addresses found for a domain or company.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `domain` | string | No | Domain to count emails for (e.g., "stripe.com"). Required if company not provided |
  | `company` | string | No | Company name to count emails for (e.g., "Stripe", "Acme Inc"). Required if domain not provided |
  | `type` | string | No | Filter for personal or generic emails only (e.g., "personal", "generic", "all") |
  | `apiKey` | string | Yes | Hunter.io API Key |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `department` | object | Email count breakdown by department |
  | ↳ `executive` | number | Number of executive department emails |
  | ↳ `it` | number | Number of IT department emails |
  | ↳ `finance` | number | Number of finance department emails |
  | ↳ `management` | number | Number of management department emails |
  | ↳ `sales` | number | Number of sales department emails |
  | ↳ `legal` | number | Number of legal department emails |
  | ↳ `support` | number | Number of support department emails |
  | ↳ `hr` | number | Number of HR department emails |
  | ↳ `marketing` | number | Number of marketing department emails |
  | ↳ `communication` | number | Number of communication department emails |
  | ↳ `education` | number | Number of education department emails |
  | ↳ `design` | number | Number of design department emails |
  | ↳ `health` | number | Number of health department emails |
  | ↳ `operations` | number | Number of operations department emails |
  | `seniority` | object | Email count breakdown by seniority level |
  | ↳ `junior` | number | Number of junior-level emails |
  | ↳ `senior` | number | Number of senior-level emails |
  | ↳ `executive` | number | Number of executive-level emails |
  | `total` | number | Total number of email addresses found |
  | `personal_emails` | number | Number of personal email addresses (individual employees) |
  | `generic_emails` | number | Number of generic/role-based email addresses (e.g., contact@, info@) |
</ReferenceDetails>