Search emails across companies matching filters
hunter.x.multi-domain-searchSearches every company matching your filters in one request; returns masked rows with reveal handles
- Price
- freeAl precio del proveedor
- Success rate
- 100 %Last 30 days · 4505 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 | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
type | cadena | Opcional | personal | generic | |
limit | entero | Opcional | rows per page, default and maximum 100 | 1 |
industry | cadena | Opcional | numeric IDs from Hunter's industries.json catalog, comma-separated | |
location | cadena | Opcional | ISO 3166-1 alpha-2 country codes, comma-separated | US |
headcount | cadena | Opcional | one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ | |
seniority | cadena | Opcional | junior, senior, executive - comma-separate to combine | |
department | cadena | 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 | cadena | Opcional | exact slugs from Hunter's technologies.json catalog, comma-separated | |
company_name | cadena | Opcional | company name to match | Stripe |
company_type | cadena | Opcional | educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship | |
founded_year | entero | Opcional | four-digit year from 1000 up to next year | |
search_after | cadena | 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 | entero | Opcional | integer from 2 to 100 | |
required_field | cadena | Opcional | comma-separated fields a result must have - full_name, position, phone_number | |
verification_status | cadena | Opcional | valid, accept_all, unknown | |
- Parámetros de consulta
typecadenaOpcionalpersonal | generic
limitenteroOpcionalrows per page, default and maximum 100
Ejemplo:
1industrycadenaOpcionalnumeric IDs from Hunter's industries.json catalog, comma-separated
locationcadenaOpcionalISO 3166-1 alpha-2 country codes, comma-separated
Ejemplo:
USheadcountcadenaOpcionalone of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
senioritycadenaOpcionaljunior, senior, executive - comma-separate to combine
departmentcadenaOpcionalexecutive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement
Ejemplo:
executiveper_domainbooleanoOpcionalwhen true, include a per-domain email-count breakdown in meta
technologycadenaOpcionalexact slugs from Hunter's technologies.json catalog, comma-separated
company_namecadenaOpcionalcompany name to match
Ejemplo:
Stripecompany_typecadenaOpcionaleducational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship
founded_yearenteroOpcionalfour-digit year from 1000 up to next year
search_aftercadenaOpcionalpagination cursor from meta.next_search_after; this endpoint rejects offset
decision_makerbooleanoOpcionalfilters only when truthy; a false value is ignored on this endpoint
min_confidenceenteroOpcionalinteger from 2 to 100
required_fieldcadenaOpcionalcomma-separated fields a result must have - full_name, position, phone_number
verification_statuscadenaOpcionalvalid, accept_all, unknown
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a free, incluida la tarifa de servicio.