// 開発者プラットフォーム
メールインテリジェンスのための強力なAPI
メール検索、検証、エンリッチメントをアプリケーションに組み込みましょう。主要言語対応のSDKを備えたRESTful API。
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
例API リファレンスのレスポンス例
- organization.organization
- Pied Piper
- organization.industries
- computer software
- organization.company_size
- 11-50
- organization.pattern
- {first}
- organization.accept_all
- false
- emails
- 2 items
- emails[0].email
- dinesh@piedpiper.com
- emails[0].position
- Software Engineer
- emails[0].verification.status
- valid
// 01 · エンドポイント
すべてのエンドポイント、その料金とリファレンスページ
HTTPS 経由の REST、JSON の入出力、認証は2つのヘッダーで。ベース URL は https://api.tomba.io/v1 です。
エンドポイント料金課金条件
GET/email-finderA person's work email from their name and company domain料金:1 search credit課金条件:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profile料金:1 search credit per 10 results課金条件:At least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checks料金:1 verification credit課金条件:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profiles料金:1 search credit課金条件:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URL料金:1 search credit課金条件:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an article料金:1 search credit課金条件:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URL料金:5 search credits課金条件:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and region料金:1 search credit課金条件:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filters料金:1 search credit課金条件:At least one company is returned.
GET/combined/findThe person and their company from one email address料金:2 search credits課金条件:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socials料金:1 search credit課金条件:A company is returned.
GET/technologyThe technologies a website runs, by category料金:Free課金条件:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniority料金:1 email count credit課金条件:Every call.
GET/similarCompanies similar to a domain, with their industry料金:1 search credit per 10 results課金条件:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their share料金:1 email count credit課金条件:Every successful call, including an empty result.
GET/locationWhere a company's people are, by country料金:1 email count credit課金条件:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handles料金:1 search credit課金条件:A person is returned.
ベース URL
https://api.tomba.io/v1 · すべてのリクエストに X-Tomba-Key と X-Tomba-Secret を付けて送信します。API リファレンスのすべてのエンドポイント // 02 · 一括処理
最大25,000行のリスト向け一括ジョブ
リスト、行、または CSV を /bulk/ に POST し、終了時に署名付き Webhook を受け取り、初回ダウンロード時に1回だけ支払います。
| 一括処理の種類 | 入力 | 最大行数 | |
|---|---|---|---|
POST/bulk/search | Domains or company names | 25,000 | |
POST/bulk/similar | Domains or company names | 5,000 | |
POST/bulk/company | Domains or company names | 25,000 | |
POST/bulk/finder | Names, with a domain or company name | 10,000 | |
POST/bulk/enrich | Email addresses | 20,000 | |
POST/bulk/linkedin | LinkedIn profile URLs | 20,000 | |
POST/bulk/author | Article URLs | 5,000 | |
POST/bulk/verifier | Email addresses | 20,000 | |
POST/bulk/phone-finder | Email addresses, LinkedIn URLs or domains | 10,000 | |
POST/bulk/phone-validator | Phone numbers, with an optional country | 10,000 |
横にスクロールするとすべての列を表示できます
// 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. レート制限
// 04 · sdk とツール
13の SDK、CLI、MCP サーバー
公式ライブラリは同じエンドポイントをラップしています。CLI と MCP サーバーはキーまたは OAuth を使用します。
- Python
pip install tomba-io - Node.js
npm install tomba - PHP
composer require tomba-io/php - Ruby
gem install tomba - Go
go get github.com/tomba-io/go - C#
dotnet add package Tomba - Rust
cargo add tomba - Deno
deno add jsr:@tomba/sdk - Dart
dart pub add tomba - Elixir
{:tomba, "~> 1.0"} - Lua
luarocks install tomba - Perl
cpanm Tomba::Finder - R
remotes::install_github("tomba-io/r")
ドメイン検索、メールファインダー、メール検証、著者ファインダー、メールエンリッチメント、企業エンリッチメント、LinkedIn検索、電話番号検索、電話番号検証、類似ドメイン検索のエンドポイントを提供しています。
Python、Node.js、PHP、Ruby、Go、Dart、Lua、R、Elixir、C#の公式SDKがあります。HTTPリクエストが可能なすべての言語でREST APIをご利用いただけます。
制限はエンドポイントとプランごとに設定されています。Freeプランではほとんどのエンドポイントが毎秒1リクエスト、1日5〜20リクエストです。Proでは毎秒5〜8リクエスト、1日最大4,000リクエストです。Pro PlusとScaleは無制限で、Enterpriseは毎秒の制限なしで1日100,000リクエストまで利用できます。GET /v1/rate-limits でアカウントの制限を確認できます。詳しくはレート制限をご覧ください。
すべてのリクエストに2つのヘッダーが必要です：X-Tomba-Key（APIキー）とX-Tomba-Secret（APIシークレット）。どちらもTombaダッシュボードで確認できます。
はい。無料プランには30日ごとに25検索クレジットが含まれ、クレジットカードは不要です。
はい、ドメイン検索、メールファインダー、メール検証など、専用のバルクエンドポイントがあります。CSVファイルのアップロードやバッチリクエストで大量処理が可能です。
すべてのAPIレスポンスはJSON形式で返されます。各レスポンスには、リクエストされたデータとともにレート制限情報やリクエストステータスなどのメタデータが含まれます。
はい、TombaはGDPRに完全準拠しています。すべてのデータは公開情報から取得されており、データ主体が削除を要求するための仕組みを提供しています。