// post /v1/reveal/search
企業リビール API
任意のドメインから完全な企業インテリジェンスを取得 業種、売上、従業員数、テクノロジースタック、ソーシャルプロフィール、認証済みの意思決定者の連絡先を1回のAPI呼び出しで。
1 search credit
// api コンソール
例API リファレンスのレスポンス例
- companies
- 1 item
- companies[0].name
- Pied Piper
- companies[0].website_url
- piedpiper.com
- companies[0].industry
- computer software
- companies[0].company_size
- 11-50
- companies[0].city
- Palo Alto
- companies[0].founded
- 2014
- companies[0].total_emails
- 48
// 01 · リクエスト
Company Search は1回の HTTPS リクエストです
キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。
POST
/reveal/searchquery必須- What you are looking for, in plain language
page1- Result page
curl -X POST https://api.tomba.io/v1/reveal/search \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Compression startups in California","page":1}'const res = await fetch("https://api.tomba.io/v1/reveal/search", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({"query":"Compression startups in California","page":1})
});
const { data } = await res.json();import os, requests
res = requests.post(
"https://api.tomba.io/v1/reveal/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={"query":"Compression startups in California","page":1},
)
data = res.json()["data"]// 02 · レスポンス
返される内容
どの言語でも同じ JSON です。Tomba が把握していないフィールドは null となり、推測はしません。
POST
/reveal/searchdata.companies[]array | null- Name, website, description, industry, size, type, founded, revenue, location, social links
data.companies[].total_emailsinteger- Addresses Tomba holds for the company
data.companies[].total_similarinteger- Similar companies Tomba knows
meta.total, meta.pagesinteger- Companies that match, and pages
meta.page, meta.limitinteger- This page and its size
meta.filtersobject- The filters Tomba read from your query
POST /reveal/search
200 OK· 1 search credit
{
"success": true,
"data": {
"companies": [
{
"name": "Pied Piper",
"description": "Middle-out compression for files and video.",
"country": "US",
"state": "California",
"city": "Palo Alto",
"street_address": "5230 Newell Road",
"postal_code": "94303",
"industry": "computer software",
"company_size": "11-50",
"type": "privately held",
"founded": "2014",
"website_url": "piedpiper.com",
"total_emails": 48,
"revenue": "",
"phone_number": false,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"facebook_url": "",
"twitter_url": "",
"total_similar": 2
}
]
},
"meta": {
"total": 64,
"page": 1,
"limit": 10,
"pages": 7,
"filters": {
"location_state": {
"include": [
"California"
]
},
"industry": {
"include": [
"computer software"
]
}
}
}
}// 03 · 料金と制限
呼び出しの料金
呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。
// 料金
1search credit
課金条件: At least one company is returned.
エラー、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. レート制限
企業名、説明、業種、売上範囲、従業員数、本社、テクノロジースタック、ソーシャルプロフィール、メールパターン、MXレコード、WHOISデータ、類似企業、ドメインメタデータを含む包括的な企業プロフィール。
企業リビールは企業エンリッチメントとコンタクト発見を組み合わせています。完全な企業プロフィールに加え、認証済みの意思決定者のメールと電話番号を1回のAPI呼び出しで返します。
企業リビールあたり1クレジット。ドメインのデータが見つからない場合、クレジットは消費されません。結果に対してのみ課金されます。
はい。一括企業リビールAPIでCSVまたはAPIバッチにより数千件のドメインを処理できます。
POST /reveal/search はすべてのプランで毎秒最大5リクエストまで受け付けます。すべてのレスポンスにレート制限ヘッダーが含まれます。詳しくはレート制限をご覧ください。
はい。Tombaは公開されているビジネスデータのみを処理し、オプトアウトリクエストを尊重し、データ最小化の原則を適用しています。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。
企業プロフィールは毎月更新、テクノロジーデータは四半期ごと、ドメイン/DNS情報は各ルックアップでリアルタイム検証されます。