HunterDados de pessoasEnrichment

Search emails across companies matching filters

hunter.x.multi-domain-search

Searches every company matching your filters in one request; returns masked rows with reveal handles

Price: freePelo preço do provedor
Success rate: 100%Last 30 days · 4.505 calls
Latency p50: 238 msp95 379 ms
Last verified: —Not verified yet

POSThttps://toolswitch.dev/v1/tools/hunter.x.multi-domain-search?limit=1&location=US&department=executivePreview

Uses platform quota
Synchronous response
Reads public data

Parâmetros

at least one company or email filter is required (Hunter 400 otherwise). This POST takes filters as query parameters, matching Hunter's documented request - not a JSON body, and there is no companies array. Cheap probe: queryParams {location: "US", department: "executive", limit: 1}. Results are masked; unlock addresses via hunter.x.multi-domain-search-reveal. Beta: parameters may change.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`type`	string	Opcional	personal \| generic
`limit`	inteiro	Opcional	rows per page, default and maximum 100	`1`
`industry`	string	Opcional	numeric IDs from Hunter's industries.json catalog, comma-separated
`location`	string	Opcional	ISO 3166-1 alpha-2 country codes, comma-separated	`US`
`headcount`	string	Opcional	one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
`seniority`	string	Opcional	junior, senior, executive - comma-separate to combine
`department`	string	Opcional	executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement	`executive`
`per_domain`	booleano	Opcional	when true, include a per-domain email-count breakdown in meta
`technology`	string	Opcional	exact slugs from Hunter's technologies.json catalog, comma-separated
`company_name`	string	Opcional	company name to match	`Stripe`
`company_type`	string	Opcional	educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship
`founded_year`	inteiro	Opcional	four-digit year from 1000 up to next year
`search_after`	string	Opcional	pagination cursor from meta.next_search_after; this endpoint rejects offset
`decision_maker`	booleano	Opcional	filters only when truthy; a false value is ignored on this endpoint
`min_confidence`	inteiro	Opcional	integer from 2 to 100
`required_field`	string	Opcional	comma-separated fields a result must have - full_name, position, phone_number
`verification_status`	string	Opcional	valid, accept_all, unknown

Parâmetros de consulta
typestringOpcional
personal | generic
limitinteiroOpcional
rows per page, default and maximum 100
Exemplo: 1
industrystringOpcional
numeric IDs from Hunter's industries.json catalog, comma-separated
locationstringOpcional
ISO 3166-1 alpha-2 country codes, comma-separated
Exemplo: US
headcountstringOpcional
one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
senioritystringOpcional
junior, senior, executive - comma-separate to combine
departmentstringOpcional
executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement
Exemplo: executive
per_domainbooleanoOpcional
when true, include a per-domain email-count breakdown in meta
technologystringOpcional
exact slugs from Hunter's technologies.json catalog, comma-separated
company_namestringOpcional
company name to match
Exemplo: Stripe
company_typestringOpcional
educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship
founded_yearinteiroOpcional
four-digit year from 1000 up to next year
search_afterstringOpcional
pagination cursor from meta.next_search_after; this endpoint rejects offset
decision_makerbooleanoOpcional
filters only when truthy; a false value is ignored on this endpoint
min_confidenceinteiroOpcional
integer from 2 to 100
required_fieldstringOpcional
comma-separated fields a result must have - full_name, position, phone_number
verification_statusstringOpcional
valid, accept_all, unknown

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

Preview

curl -X POST 'https://toolswitch.dev/v1/tools/hunter.x.multi-domain-search?limit=1&location=US&department=executive' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/hunter.x.multi-domain-search?limit=1&location=US&department=executive",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/hunter.x.multi-domain-search?limit=1&location=US&department=executive", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a free, incluindo a taxa de serviço.