// get /v1/email-format
邮箱格式 API
检测任何公司域名使用的邮箱格式模式。返回所有检测到的模式及其百分比分布，以便您预测员工邮箱地址。
1 email count credit
// api 控制台
示例API 参考中的示例响应
- [0].format
- {first}
- [0].percentage
- 66
// 01 · 请求
Email Format只需一个 HTTPS 请求
使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。
GET
/email-formatdomain必填- Company domain
curl -G https://api.tomba.io/v1/email-format \
--data-urlencode "domain=piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
domain: "piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/email-format?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-format",
params={
"domain": "piedpiper.com",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · 响应
返回的内容
JSON，在任何语言中都相同。Tomba 不知道的字段为 null，绝不猜测。
GET
/email-formatdata[].formatstring- Pattern such as {first}.{last}
data[].percentageinteger- Share of the company's addresses
GET /email-format
200 OK· 1 email count credit
{
"data": [
{
"format": "{first}",
"percentage": 66
},
{
"format": "{first}.{last}",
"percentage": 34
}
]
}// 03 · 费用和限制
调用的费用
仅在满足以下条件时才对调用收费。速率限制取决于您的套餐。
// 费用
1email count credit
收费条件: Every successful call, including an empty result.
错误、429 和 451 响应，以及在用量窗口内重复的相同请求均不收费。
积分如何运作// 速率限制
每秒 / 每分钟 / 每天请求数| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
横向滚动可查看所有列
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. 速率限制
常见模式包括：first.last@、f.last@、first@、last.first@、first_last@ 等。所有检测到的变体均附带使用百分比返回。
模式基于我们数据库中经验证的邮箱地址计算。百分比反映该域名已知联系人中的实际分布。
可以。许多公司使用不止一种邮箱格式。API 返回按频率排序的所有检测到的模式。
每次邮箱格式请求消耗 1 个积分。
使用主要模式为潜在客户生成邮箱地址、验证猜测的地址，或用预测的格式丰富您的 CRM 数据。
13 个官方 SDK：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby 和 Rust。