- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: true通过 GET /v1/bulk/search/1042/progress 轮询进度 - 03completed
bulk.completed已签名的 webhook 发送至您的 webhook_url
GET /v1/bulk/search/1042/download?file=full首次下载时收费 · 任务 180 天后过期// 01 · 输入
批量Domain Search任务的输入
在应用中上传最大 4 MB 的 CSV,或将列表、行或文件发送到 POST /v1/bulk/search。列会根据表头行自动识别;设置字段索引即可自行选择。
/bulk/search列domain_field_index- Domain
company_name_field_index- Company name
/bulk/search选项input_type- domain or company; company when the input has a company name column and no domain column
max_emails_per_domain- Addresses per domain: 1, 10 (the default), 20, 50 or 100
email_type, email_type_mode- all (the default), personal or generic; only (the default) or priority
departments, departments_mode- Department names such as ["sales", "marketing"]; only or priority
verify_emails- true verifies the addresses found
find_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
boost_score_from_sources- true adds 10 points, up to 90, to an unverified address found on at least 5 pages
// 02 · api
一个请求即可启动任务
一次调用即可创建并启动任务,然后跟踪其进度或接收已签名的 bulk.completed 事件。每个结果行即 GET /domain-search 返回的内容。
curl -X POST "https://api.tomba.io/v1/bulk/search" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/search", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"organization": {
"website_url": "piedpiper.com",
"organization": "Pied Piper",
"location": {
"country": "US",
"city": "Palo Alto",
"state": "CA",
"street_address": "5230 Newell Road",
"postal_code": "94303"
},
"social_links": {
"twitter_url": null,
"facebook_url": null,
"instagram_url": null,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"github_url": null,
"youtube_url": null,
"pinterest_url": null,
"tiktok_url": null
},
"disposable": false,
"webmail": false,
"phone_number": false,
"industries": "computer software",
"founded": "2014",
"company_size": "11-50",
"company_type": "privately held",
"revenue": null,
"accept_all": false,
"description": "Middle-out compression for files and video.",
"pattern": "{first}",
"total_similar": 2,
"keywords": [
"compression",
"middle-out",
"decentralized internet"
],
"ranking": null,
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"last_updated": "2025-01-15T10:32:00+01:00"
},
"emails": [
{
"email": "dinesh@piedpiper.com",
"first_name": "Dinesh",
"last_name": "Chugtai",
"full_name": "Dinesh Chugtai",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Software Engineer",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 99,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
]
},
{
"email": "gilfoyle@piedpiper.com",
"first_name": "Bertram",
"last_name": "Gilfoyle",
"full_name": "Bertram Gilfoyle",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Systems Architect",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 97,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
]
}
]
},
"meta": {
"total": 12,
"pageSize": 10,
"current": 1,
"total_pages": 2,
"params": {
"domain": "piedpiper.com",
"company": "",
"page": 1,
"limit": 10,
"department": "engineering",
"country": null,
"type": "all",
"live": false,
"enrich_mobile": false,
"webhook_url": null
}
}
}// 03 · 费用和限制
任务的费用
创建或启动任务不收费。费用仅在首次下载结果时收取一次。
// 按行计费
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
文档中的批量计费说明- 行数:每个任务最多 25,000 行
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
// 04 · 随处使用
从应用或代码运行Domain Search任务
同样的任务,同样的积分:在应用中上传文件、调用 API,或在电子表格或无代码工具中操作。
- REST API基于 HTTPS 的 JSON,13 个 SDK,已签名的 webhook。
GET /v1/domain-search - 批量 CSV在应用中上传列表或通过 POST 发送到 /bulk;完成后下载。
POST /v1/bulk/{type} - Google 表格和 Excel调用相同端点的公式和侧边栏。
=TOMBA_SEARCH(A2) - Zapier、Make、n8n用于查找器、验证器和数据丰富的无代码操作。
Zapier · Make · n8n · Pipedream
完整请求参考: /api/bulk/domain-search
// 5,000 条线索基准测试
有效邮箱数量超过我们测试的其他八款工具
真实数据。相同输入。无人工干预。完全透明。我们用同一份 5,000 行的输入文件,对多款邮箱查找工具进行了正面对比测试。
| 排名 | 工具 | 来自网站 | 来自公司名称 | 总计 |
|---|---|---|---|---|
| 1 | 2,02681.0% | 1,98979.6% | 4,015 | |
| 2 | 1,91876.7% | 1,95778.3% | 3,875 | |
| 3 | 1,88075.2% | 1,87775.1% | 3,757 | |
| 4 | 1,48359.3% | 1,61364.5% | 3,096 | |
| 5 | 1,00140.0% | 1,14145.6% | 2,142 | |
| 6 | 88735.5% | 99539.8% | 1,882 | |
| 7 | 1,05142.0% | 74930.0% | 1,800 | |
| 8 | 98839.5% | 从公司名称找到的不足 1%:该工具需要网站或域名:190.8% | 1,007 | |
| 9 | 82433.0% | 从公司名称找到的不足 1%:该工具需要网站或域名:220.9% | 846 |
Tomba.io 从 5,000 条线索中找到 4,015 个有效邮箱:在 9 款受测工具中排名第 #1。
Tomba 自行测试,2026 年 2 月。一个包含 5,000 条线索的文件,其中 2,500 条带有公司网站,2,500 条仅有公司名称,在每款工具中运行且未做任何人工清理。仅计入工具标记为有效或已验证的地址;百分比基于每类 2,500 条输入计算。
从公司名称找到的不足 1%:该工具需要网站或域名.