// get /v1/email-format
メールフォーマット API
任意の企業ドメインで使用されているメールフォーマットパターンを検出。検出されたすべてのパターンとパーセンテージ分布を返し、従業員のメールアドレスを予測。
1 email count credit
// api コンソール
例API リファレンスのレスポンス例
- [0].format
- {first}
- [0].percentage
- 66
// 01 · リクエスト
Email Format は1回の 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データを予測フォーマットでエンリッチできます。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。