Multi-Domain Search

Multi-domain search

Search professional email addresses across many companies at once using a structured filter set. Returns masked rows — no email address or phone number; use the reveal endpoint to unmask. This masked survey operation is free. At least one filter is required. Filters may be sent in the request body (JSON or form-encoded) or as query-string parameters; the body is therefore optional.

post/multi-domain-search

Request

  • Base URL: https://api.hunter.io/v2
  • URL: https://api.hunter.io/v2/multi-domain-search
  • Auth: one of:
    • API key in query parameter api_key
    • API key in header X-API-KEY
    • HTTP bearer

Query parameters

api_keystring

Hunter API key. Prefer the X-API-KEY header outside browser links.

Request body

api_keystring
company_namestring

Comma-separated company names.

locationstring

Comma-separated ISO 3166-1 alpha-2 country codes.

industrystring

Comma-separated integer industry codes.

headcountstring

Comma-separated company-size buckets (e.g. 11-50, 51-200).

company_typestring

Comma-separated Hunter company types.

founded_yearstring

Comma-separated founding years.

technologystring

Comma-separated technology slugs.

departmentstring

Comma-separated departments (e.g. executive, sales, marketing).

senioritystring

Comma-separated seniority levels: junior, senior, executive.

typestring

Comma-separated email types: personal, generic.

provenancestring

Comma-separated provenance values: found, inferred. Early access: accounts it has not been enabled for receive a 400 (wrong_params) for this parameter.

verification_statusstring

Comma-separated verification statuses: valid, accept_all, unknown.

required_fieldstring

Comma-separated fields that every returned person must have (AND): full_name, position, phone_number.

min_confidenceinteger

Minimum email confidence score.

limitinteger

Number of rows to return per page.

search_afterstring

Opaque pagination cursor from meta.next_search_after. Omit for the first page.

Example request

{
  "company_name": "Stripe,Acme",
  "location": "US,FR",
  "industry": "4,25",
  "headcount": "11-50,51-200",
  "company_type": "educational,government agency",
  "founded_year": "2015,2016",
  "technology": "rails,stripe",
  "department": "executive,marketing",
  "seniority": "senior,executive",
  "type": "personal",
  "provenance": "found",
  "verification_status": "valid,accept_all",
  "required_field": "full_name,position",
  "min_confidence": 80
}

Response

Masked rows matching the filters.

Example response

{
  "data": [
    {
      "provenance": "found",
      "domain": "example.com",
      "reveal_handle": "aAKWnmY9z-P8kCj6sBQjZ8yiYnNSMKb0"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.