Skip to main content
Hunter logo

​
Overview

Add Hunter to any ModuleX agent or workflow. Find and verify professional email addresses, search domains for contacts, and manage leads using the Hunter.io API (api.hunter.io/v2).
Categories: Sales · Marketing & Sales · Lead Generation · Email · Auth: API Key · Actions: 13

​
Authentication

​
API Key Authentication

Authenticate using your Hunter API key
1

Step 1

Go to https://hunter.io and sign in
2

Step 2

Navigate to your account API settings at https://hunter.io/api-keys
3

Step 3

Copy your API key
4

Step 4

Paste the API key below

​
Required Credentials

FieldDescriptionRequiredFormat
Hunter API KeyYour Hunter API key from hunter.io/api-keysYesxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Available Actions

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "plan_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Plan Name"
    },
    "plan_level": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Plan Level"
    },
    "reset_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Reset Date"
    },
    "team_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Team Id"
    },
    "calls_used": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Calls Used"
    },
    "calls_available": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Calls Available"
    }
  },
  "required": [
    "success"
  ],
  "title": "AccountInformationOutput",
  "type": "object"
}

​
Parameters

​
email
string
required
The email address you want to find information about

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CombinedEnrichmentOutput",
  "type": "object"
}

​
Parameters

​
email
string
required
The email address of the lead
​
first_name
string
The first name of the lead
​
last_name
string
The last name of the lead
​
position
string
The job title of the lead
​
company
string
The name of the company the lead is working in
​
company_industry
string
The sector of the company. Allowed values: Animal, Art & Entertainment, Automotive, Beauty & Fitness, Books & Literature, Education & Career, Finance, Food & Drink, Game, Health, Hobby & Leisure, Home & Garden, Industry, Internet & Telecom, Law & Government, Manufacturing, News, Real Estate, Science, Retail, Sport, Technology, Travel
​
company_size
string
The size of the company the lead is working in
​
confidence_score
integer
Estimation of the probability the email address returned is correct, between 0 and 100
​
website
string
The domain name of the company
​
country_code
string
The country of the lead (ISO 3166-1 alpha-2 standard)
​
linkedin_url
string
The address of the public profile on LinkedIn
​
phone_number
string
The phone number of the lead
​
twitter
string
The Twitter handle of the lead
​
notes
string
Some personal notes about the lead
​
source
string
The source where the lead has been found
​
leads_list_id
string
The identifier of the list the lead belongs to. If not specified, the lead is saved in the last list created

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateLeadOutput",
  "type": "object"
}

​
Parameters

​
lead_id
string
required
The unique identifier of the lead

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteLeadOutput",
  "type": "object"
}

​
Parameters

​
domain
string
Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided
​
company
string
The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided
​
limit
integer
required
Specifies the max number of email addresses to return (Default: 100)
​
type
string
Get only personal or generic email addresses. Allowed values: personal, generic
​
seniority
string
Get only email addresses for people with the selected seniority level(s). Comma-separated values: junior, senior, executive
​
department
string
Get only email addresses for people working in the selected department(s). Comma-separated values: executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "disposable": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Disposable"
    },
    "webmail": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Webmail"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "pattern": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pattern"
    },
    "organization": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Organization"
    },
    "emails": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Emails",
      "type": "array"
    },
    "total_results": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total Results"
    }
  },
  "required": [
    "success"
  ],
  "title": "DomainSearchOutput",
  "type": "object"
}

​
Parameters

​
domain
string
Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided
​
company
string
The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided
​
type
string
Get only personal or generic email addresses. Allowed values: personal, generic

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    },
    "personal_emails": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Personal Emails"
    },
    "generic_emails": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Generic Emails"
    },
    "department": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Department"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailCountOutput",
  "type": "object"
}

​
Parameters

​
domain
string
Domain name from which you want to find the email addresses. For example, ‘stripe.com’. Either domain or company must be provided
​
company
string
The company name from which you want to find the email addresses. For example, ‘stripe’. Either domain or company must be provided
​
first_name
string
required
The person’s first name
​
last_name
string
required
The person’s last name

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "score": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Score"
    },
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Position"
    },
    "twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Twitter"
    },
    "linkedin_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Linkedin Url"
    },
    "phone_number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Phone Number"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    },
    "sources": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Sources",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailFinderOutput",
  "type": "object"
}

​
Parameters

​
email
string
required
The email address you want to verify

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "result": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    },
    "score": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Score"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "regexp": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Regexp"
    },
    "gibberish": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Gibberish"
    },
    "disposable": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Disposable"
    },
    "webmail": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Webmail"
    },
    "mx_records": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Mx Records"
    },
    "smtp_server": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Smtp Server"
    },
    "smtp_check": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Smtp Check"
    },
    "accept_all": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Accept All"
    },
    "block": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Block"
    },
    "sources": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Sources",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "EmailVerifierOutput",
  "type": "object"
}

​
Parameters

​
lead_id
string
required
The unique identifier of the lead

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "first_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "First Name"
    },
    "last_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Name"
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Position"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetLeadOutput",
  "type": "object"
}

​
Parameters

​
leads_list_id
string
required
Identifier of the leads list to retrieve
​
limit
integer
required
A limit on the number of leads to be returned. Limit can range between 1 and 100 (Default: 100)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "leads": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetLeadsListOutput",
  "type": "object"
}

​
Parameters

​
leads_list_id
string
Only returns the leads belonging to this list
​
email
string
Filter leads by email
​
first_name
string
Filter leads by first name
​
last_name
string
Filter leads by last name
​
position
string
Filter leads by position
​
company
string
Filter leads by company
​
industry
string
Filter leads by industry
​
website
string
Filter leads by website
​
country_code
string
Filter leads by country code (ISO 3166-1 alpha-2)
​
company_size
string
Filter leads by company size
​
source
string
Filter leads by source
​
twitter
string
Filter leads by Twitter handle
​
linkedin_url
string
Filter leads by LinkedIn URL
​
phone_number
string
Filter leads by phone number
​
sync_status
string
Filter by synchronization status. Allowed values: pending, error, success
​
sending_status
string
Filter by sending status. Comma-separated values: clicked, opened, sent, pending, error, bounced, unsubscribed, replied
​
verification_status
string
Filter by verification status. Comma-separated values: accept_all, disposable, invalid, unknown, valid, webmail, pending
​
last_activity_at
string
Filter by last activity. Allowed values: * (any), ~ (unset)
​
last_contacted_at
string
Filter by last contact date. Allowed values: * (any), ~ (unset)
​
query
string
Only returns leads with First Name, Last Name, or Email matching the query
​
limit
integer
required
A limit on the number of leads to be returned. Limit can range between 1 and 1000 (Default: 100)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "leads": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads",
      "type": "array"
    },
    "total": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Total"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLeadsOutput",
  "type": "object"
}

​
Parameters

​
limit
integer
required
A limit on the number of lists to be returned. Limit can range between 1 and 100 (Default: 100)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "leads_lists": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Leads Lists",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListLeadsListsOutput",
  "type": "object"
}

​
Parameters

​
lead_id
string
required
The unique identifier of the lead
​
email
string
The email address of the lead
​
first_name
string
The person’s first name
​
last_name
string
The person’s last name
​
position
string
The person’s position in the company
​
company
string
The company name
​
website
string
The website URL of the company
​
phone_number
string
The person’s phone number

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateLeadOutput",
  "type": "object"
}

​
Limits & Quotas

  • Free plan: 25 searches and 50 verifications per month.
  • Paid plans: Limits scale with plan tier (up to 30,000+ requests/month on Enterprise).
  • Rate limit: 10 requests/second across all endpoints.
  • Error model: Non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

Apollo.io

Brandfetch

Clay