Hunter io
Find and verify professional email addresses
Integrate Hunter into the workflow. Can search domains, find email addresses, verify email addresses, discover companies, find companies, and count email addresses.
| Parameter | Type | Required | Description |
|---|
query | string | No | No description |
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 | No description |
technology | string | No | No description |
apiKey | string | Yes | No description |
| Parameter | Type | Description |
|---|
results | array | List of companies matching the search criteria |
↳ domain | string | Company domain |
↳ name | string | Company/organization name |
↳ headcount | number | Company size/headcount |
↳ technologies | array | Technologies used by the company |
↳ email_count | number | Total number of email addresses found |
| Parameter | Type | Required | Description |
|---|
domain | string | Yes | Domain name to search for email addresses (e.g., "stripe.com", "company.io") |
limit | number | No | No description |
offset | number | No | No description |
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 | No description |
| 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 |
↳ seniority | string | Seniority level (junior, senior, executive) |
↳ department | string | Department (executive, it, finance, management, sales, legal, support, hr, marketing, communication) |
↳ 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 |
description | string | Description of the organization |
industry | string | Industry classification of the organization |
twitter | string | Twitter handle of the organization |
facebook | string | Facebook page URL of the organization |
linkedin | string | LinkedIn company page URL |
instagram | string | Instagram profile of the organization |
youtube | string | YouTube channel of the organization |
technologies | array | Technologies used by the organization |
country | string | Country where the organization is headquartered |
state | string | State/province where the organization is located |
city | string | City where the organization is located |
postal_code | string | Postal code of the organization |
street | string | Street address of the organization |
Finds the most likely email address for a person given their name and company domain.
| Parameter | Type | Required | Description |
|---|
domain | string | Yes | Company domain name (e.g., "stripe.com", "company.io") |
first_name | string | Yes | No description |
last_name | string | Yes | No description |
company | string | No | Company name (e.g., "Stripe", "Acme Inc") |
apiKey | string | Yes | No description |
| 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) |
email | string | The found email address |
score | number | Confidence score (0-100) for the found email address |
Verifies the deliverability of an email address and provides detailed verification status.
| Parameter | Type | Required | Description |
|---|
email | string | Yes | No description |
apiKey | string | Yes | No description |
| 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) |
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 |
| Parameter | Type | Required | Description |
|---|
domain | string | Yes | Domain to find company data for (e.g., "stripe.com", "company.io") |
apiKey | string | Yes | No description |
| Parameter | Type | Description |
|---|
company | object | Company information |
↳ name | string | Company name |
↳ domain | string | Company domain |
↳ industry | string | Industry classification |
↳ size | string | Company size/headcount range |
↳ country | string | Country where the company is located |
↳ linkedin | string | LinkedIn company page URL |
↳ twitter | string | Twitter handle |
person | object | Person information (undefined for companies_find tool) |
| 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 | No description |
| 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@) |
