// api 控制台
示例API 参考中的示例响应
- email.email
- richard@piedpiper.com
- email.result
- deliverable
- email.status
- valid
- email.score
- 99
- email.smtp_provider
- email.accept_all
- false
- email.disposable
- false
- email.webmail
- false
- email.greylisted
- false
// 这些公司的团队在使用 tomba
// 01 · 应用内
Tomba 应用中的 Email Verifier
在网页应用中粘贴邮箱：查看结论、评分及其背后的每一项检查，与 API 使用相同的积分。
// 02 · api
Email Verifier只需一个 HTTPS 请求
使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。
GET
/email-verifieremail必填- The address to verify
enrich_mobilefalse- Also return phone numbers
// 费用
各套餐速率限制1verification credit
收费条件: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
错误、429 和 451 响应，以及在用量窗口内重复的相同请求均不收费。
13 个官方 SDK： C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust. 文档中的库
GET /email-verifier
200 OK· 1 verification credit
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"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
}
],
"phone_data": null
}
}GET
/email-verifierdata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
// 03 · 判定结果
各状态的含义
每次检查都会返回状态和结果。disposable 和 unknown 结果免费。
valid1 个验证积分邮箱存在且可接收邮件。
发送。
accept_all1 个验证积分服务器接收发往任意地址的邮件，因此无法确认该邮箱。
谨慎发送，或稍后重新验证。
unknown免费检查无定论：服务器拦截了检查或未响应。
稍后重新验证。
invalid1 个验证积分该邮箱不存在。
将其从列表中删除。
disposable免费该域名属于一次性邮箱服务商。
视为无法送达。
| status | result | 含义 | 建议操作 | 费用 |
|---|---|---|---|---|
valid | deliverable | 邮箱存在且可接收邮件。 | 发送。 | 1 个验证积分 |
accept_all | risky | 服务器接收发往任意地址的邮件，因此无法确认该邮箱。 | 谨慎发送，或稍后重新验证。 | 1 个验证积分 |
unknown | risky | 检查无定论：服务器拦截了检查或未响应。 | 稍后重新验证。 | 免费 |
invalid | undeliverable | 该邮箱不存在。 | 将其从列表中删除。 | 1 个验证积分 |
disposable | (空) | 该域名属于一次性邮箱服务商。 | 视为无法送达。 | 免费 |
// 04 · 客户
客户评价
Tomba is my go-to to validate emails. Even though I might have others to do a waterfall process with, Tomba is usually the top choice in it.
Nuno PocoSales Automation Architect, clickworks.ioGreat Value for Money! The Data Accuracy rating and insights as to where and when they found the data. The responsiveness of their help team.
Leon W.Sales Director来自 G2
// 05 · 功能
结论背后的每一项检查
一次调用，完成原本要靠退信才能发现的各项检查。
邮箱检查
Tomba 向邮件服务器询问该邮箱是否存在，无需发送邮件。
域名与 MX 记录
确认域名有效，且拥有可接收邮件的邮件服务器。
catch-all 检测
标记接收所有地址的服务器，使其“接收”不会被当作 valid。
一次性邮箱与网页邮箱
在一次性邮箱和免费网页邮箱进入您的列表之前将其标记出来。
处理灰名单
当服务器要求稍后重试时，验证器会重试，而不是返回 unknown。
状态与评分
每个邮箱都会获得 valid、invalid 或 accept_all 等状态，以及 0 到 100 的评分。
邮件验证器用于确认电子邮件地址的存在及其接收消息的能力。Tomba 邮件验证器对电子邮件地址进行全面评估，检查其在网络上的公开可见性并提供相关来源。
Tomba 的邮件验证器直接连接到邮件的 SMTP 服务器，无需发送测试邮件。
邮件验证器执行多项检查，包括：格式准确性（确保邮件地址遵循标准格式）、随机地址检测（筛选无意义的邮件地址）、临时邮件检测（识别已知临时使用的域名）、网络邮件服务确认（确认常见网络邮件提供商）、MX 记录存在（验证域名中的 MX 记录）、SMTP 服务器连接（建立与 SMTP 服务器的连接）、SMTP 响应测试（在不发送实际邮件的情况下检查可送达性）和全接收域名检查（识别服务器是否接受所有邮件）。
验证器验证为"已验证"的电子邮件地址通常是可靠的。这些地址的退信率通常保持在 1% 以下。
可以。将 CSV 上传到批量邮箱验证器，一次处理数千个地址。通常 1,000 个邮箱不到 5 分钟，20,000 个以上需要几个小时。
每次验证消耗 1 积分。验证失败不消耗积分。Free 套餐不含验证积分：验证功能包含在付费套餐中。需要更多？请查看我们的价格套餐，获取更高额度。
限制按套餐计算，单位为每秒 / 每分钟 / 每天的请求数：Free 1 / 2 / 10，Basic 2 / 40 / 500，Growth 3 / 60 / 1,000，Pro 5 / 100 / 4,000。Pro Plus 和 Scale 无限制，Enterprise 每天允许 100,000 次请求，且无每秒限制。每个响应都带有速率限制响应头；请参阅速率限制。
catch-all（accept-all）域名接收发往任意地址的邮件，因此普通 SMTP 检查即使对不存在的邮箱也会报告 valid。Tomba 在每次验证中都会检测 catch-all 域名，并将其作为单独的状态报告，而不是给出虚假的 Valid。与止步于此、返回 unknown 的验证工具不同，Tomba 会进一步判定许多 catch-all 地址：请参阅Catch-All 验证器和Catch-All 查找器。