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
- 价格
- free按供应商原价
- 成功率
- 100%近 30 天 · 4,505 次
- 延迟 p50
- 238 毫秒p95 379 毫秒
- 最后验证
- —尚未验证
POSThttps://toolswitch.dev/v1/tools/hunter.x.multi-domain-search?limit=1&location=US&department=executive预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
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.
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
type | 字符串 | 可选 | personal | generic | |
limit | 整数 | 可选 | rows per page, default and maximum 100 | 1 |
industry | 字符串 | 可选 | numeric IDs from Hunter's industries.json catalog, comma-separated | |
location | 字符串 | 可选 | ISO 3166-1 alpha-2 country codes, comma-separated | US |
headcount | 字符串 | 可选 | one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ | |
seniority | 字符串 | 可选 | junior, senior, executive - comma-separate to combine | |
department | 字符串 | 可选 | executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement | executive |
per_domain | 布尔 | 可选 | when true, include a per-domain email-count breakdown in meta | |
technology | 字符串 | 可选 | exact slugs from Hunter's technologies.json catalog, comma-separated | |
company_name | 字符串 | 可选 | company name to match | Stripe |
company_type | 字符串 | 可选 | educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship | |
founded_year | 整数 | 可选 | four-digit year from 1000 up to next year | |
search_after | 字符串 | 可选 | pagination cursor from meta.next_search_after; this endpoint rejects offset | |
decision_maker | 布尔 | 可选 | filters only when truthy; a false value is ignored on this endpoint | |
min_confidence | 整数 | 可选 | integer from 2 to 100 | |
required_field | 字符串 | 可选 | comma-separated fields a result must have - full_name, position, phone_number | |
verification_status | 字符串 | 可选 | valid, accept_all, unknown | |
- 查询参数
type字符串可选personal | generic
limit整数可选rows per page, default and maximum 100
示例:
1industry字符串可选numeric IDs from Hunter's industries.json catalog, comma-separated
location字符串可选ISO 3166-1 alpha-2 country codes, comma-separated
示例:
USheadcount字符串可选one of 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
seniority字符串可选junior, senior, executive - comma-separate to combine
department字符串可选executive, it, finance, management, sales, legal, support, hr, marketing, communication, education, design, health, operations, product, research, consulting, administrative, procurement
示例:
executiveper_domain布尔可选when true, include a per-domain email-count breakdown in meta
technology字符串可选exact slugs from Hunter's technologies.json catalog, comma-separated
company_name字符串可选company name to match
示例:
Stripecompany_type字符串可选educational, educational institution, government agency, non profit, partnership, privately held, public company, self employed, self owned, sole proprietorship
founded_year整数可选four-digit year from 1000 up to next year
search_after字符串可选pagination cursor from meta.next_search_after; this endpoint rejects offset
decision_maker布尔可选filters only when truthy; a false value is ignored on this endpoint
min_confidence整数可选integer from 2 to 100
required_field字符串可选comma-separated fields a result must have - full_name, position, phone_number
verification_status字符串可选valid, accept_all, unknown
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
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());网关接口为预览版,地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 free 计费,已含服务费。