// get /v1/similar
類似ドメイン API
RESTful APIで任意のウェブサイトドメインに基づいて類似企業と競合ドメインを検索。
1 search credit per 10 results
// api コンソール
例API リファレンスのレスポンス例
- [0].website_url
- hooli.com
- [0].name
- Hooli
- [0].industries
- internet
// 01 · リクエスト
Similar Domains は1回の HTTPS リクエストです
キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。
GET
/similardomainpiedpiper.com- Company domain (or send company)
limit10- Results per page
curl -G https://api.tomba.io/v1/similar \
--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/similar?${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/similar",
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
/similardata[].website_urlstring- Each similar company's domain
data[].name, data[].industriesstring | null- Its name and industry
meta.total, meta.total_pagesinteger- Similar companies found, and pages
meta.current, meta.pageSizeinteger- This page and its size
meta.paramsobject- The parameters the search ran with
GET /similar
200 OK· 1 search credit per 10 results
{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 03 · 料金と制限
呼び出しの料金
呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。
// 料金
1 per 10search credit
課金条件: Results are returned. 1 credit per 10 results requested with limit.
エラー、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. レート制限
Tombaは業種分類、ウェブサイトコンテンツ、テクノロジースタック、オーディエンス重複、ビジネス属性を分析して最も類似したドメインを検索します。
ドメイン、企業名、業種、規模、所在地、説明、関連度スコア。
はい。任意のドメインを入力すると、関連度順にランク付けされた類似企業のリストを取得できます。
はい。バルク類似ドメインAPIでCSVまたはAPIにより複数のクエリを一括処理できます。
1リクエストあたり最大50件の類似ドメインを、関連度スコア順に返します。結果には企業名、業種、規模、所在地が含まれます。
競合調査、アカウントベースドマーケティングの類似オーディエンス、市場規模の把握、隣接業種での新しい見込み客の発見などです。
limit で指定した結果10件につき検索クレジット1で、結果が返された場合に課金されます。不明なドメインの検索は課金されません。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。