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
- freeZum Anbieterpreis
- 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
Parameter
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.
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Abfrageparameter | ||||
type | Zeichenkette | Optional | personal | generic | |
limit | Ganzzahl | Optional | rows per page, default and maximum 100 | 1 |
industry | Zeichenkette | Optional | numeric IDs from Hunter's industries.json catalog, comma-separated | |
location | Zeichenkette | Optional | ISO 3166-1 alpha-2 country codes, comma-separated | US |
headcount | Zeichenkette | Optional | one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ | |
seniority | Zeichenkette | Optional | junior, senior, executive - comma-separate to combine | |
department | Zeichenkette | Optional | executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement | executive |
per_domain | Boolean | Optional | when true, include a per-domain email-count breakdown in meta | |
technology | Zeichenkette | Optional | exact slugs from Hunter's technologies.json catalog, comma-separated | |
company_name | Zeichenkette | Optional | company name to match | Stripe |
company_type | Zeichenkette | Optional | educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship | |
founded_year | Ganzzahl | Optional | four-digit year from 1000 up to next year | |
search_after | Zeichenkette | Optional | pagination cursor from meta.next_search_after; this endpoint rejects offset | |
decision_maker | Boolean | Optional | filters only when truthy; a false value is ignored on this endpoint | |
min_confidence | Ganzzahl | Optional | integer from 2 to 100 | |
required_field | Zeichenkette | Optional | comma-separated fields a result must have - full_name, position, phone_number | |
verification_status | Zeichenkette | Optional | valid, accept_all, unknown | |
- Abfrageparameter
typeZeichenketteOptionalpersonal | generic
limitGanzzahlOptionalrows per page, default and maximum 100
Beispiel:
1industryZeichenketteOptionalnumeric IDs from Hunter's industries.json catalog, comma-separated
locationZeichenketteOptionalISO 3166-1 alpha-2 country codes, comma-separated
Beispiel:
USheadcountZeichenketteOptionalone of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
seniorityZeichenketteOptionaljunior, senior, executive - comma-separate to combine
departmentZeichenketteOptionalexecutive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement
Beispiel:
executiveper_domainBooleanOptionalwhen true, include a per-domain email-count breakdown in meta
technologyZeichenketteOptionalexact slugs from Hunter's technologies.json catalog, comma-separated
company_nameZeichenketteOptionalcompany name to match
Beispiel:
Stripecompany_typeZeichenketteOptionaleducational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship
founded_yearGanzzahlOptionalfour-digit year from 1000 up to next year
search_afterZeichenketteOptionalpagination cursor from meta.next_search_after; this endpoint rejects offset
decision_makerBooleanOptionalfilters only when truthy; a false value is ignored on this endpoint
min_confidenceGanzzahlOptionalinteger from 2 to 100
required_fieldZeichenketteOptionalcomma-separated fields a result must have - full_name, position, phone_number
verification_statusZeichenketteOptionalvalid, accept_all, unknown
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
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());Diese Gateway-API ist eine Vorschauversion; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit free einschließlich Servicegebühr abgerechnet.