// get /v1/email-count
メールカウント API
任意のドメインで見つかったメールアドレスの総数を取得。個人/汎用メール、部門別、役職レベル別に分類。
1 email count credit
// api コンソール
例API リファレンスのレスポンス例
- total
- 48
- personal_emails
- 41
- generic_emails
- 7
- department.engineering
- 12
- department.finance
- 2
- department.hr
- 1
- department.it
- 3
- department.marketing
- 4
- department.operations
- 2
// 01 · リクエスト
Email Count は1回の HTTPS リクエストです
キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。
GET
/email-countdomain必須- Company domain
curl -G https://api.tomba.io/v1/email-count \
--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-count?${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-count",
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-countdata.totalinteger- All addresses
data.personal_emails, data.generic_emailsinteger- Addresses of people, and role addresses such as sales@
data.departmentobject- Addresses per team: engineering, sales, marketing, executive and 18 more
data.seniorityobject- Addresses per level: junior, senior, executive
website_idinteger- Tomba's ID for the company record; 0 when it has none
GET /email-count
200 OK· 1 email count credit
{
"data": {
"total": 48,
"personal_emails": 41,
"generic_emails": 7,
"department": {
"engineering": 12,
"finance": 2,
"hr": 1,
"it": 3,
"marketing": 4,
"operations": 2,
"management": 3,
"sales": 5,
"legal": 1,
"support": 2,
"communication": 1,
"executive": 4,
"accounting": 0,
"administrative": 1,
"diversity": 0,
"facilities": 0,
"pr": 0,
"security": 0,
"software": 0,
"warehouse": 0,
"healthcare": 0,
"education": 0
},
"seniority": {
"junior": 12,
"senior": 22,
"executive": 7
}
},
"website_id": 128734
}// 03 · 料金と制限
呼び出しの料金
呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。
// レート制限
リクエスト数（秒／分／日）| 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. レート制限
メール総数、個人メール数、汎用メール数、部門別内訳（エンジニアリング、営業、マーケティング、人事、財務、IT、法務、サポート、オペレーション、管理、コミュニケーション）、役職レベル分布（ジュニア、シニア、エグゼクティブ）。
はい。メールカウントリクエストあたり1クレジット。フルドメイン検索を実行する前にドメインの規模をプレビューするためにご利用ください。
エンジニアリング、財務、人事、IT、マーケティング、オペレーション、管理、営業、法務、サポート、コミュニケーション。
ジュニア、シニア、エグゼクティブ。
はい。複数のドメインをクエリしてカウントを集計することで、任意の業種やセグメントの総アドレス可能連絡先数を推定できます。
カウントはクローラーが新しいメールアドレスを発見するたびにリアルタイムで更新されます。データは4億5,000万以上のコンタクトデータベースの最新状態を反映しています。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。