本文へスキップ

// post /v1/bulk/similar

一括類似ドメイン API

1回の非同期一括ジョブで、何千ものアカウントの類似企業と競合ドメインを見つけます。

Domains or company names最大 5,000 行
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 01 · リクエスト

一括Similar Domains は1回の HTTPS リクエストです

キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。

type
similar
list | data | file
Domains or company names
launch
true ですぐにジョブを開始
webhook_url
ジョブ終了時に署名付きイベントを受信
rows
1ジョブあたり最大 5,000 行
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 02 · レスポンス

返される内容

どの言語でも同じ JSON です。Tomba が把握していないフィールドは null となり、推測はしません。

GET/similar
data[].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
POST /bulk/similar
201 Created
{
  "data": {
    "id": 1042
  }
}
各行は GET /similar が返す形式です
200 OK
{
  "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 search credit per domain with at least one similar company.

Charged once, at the first download; later downloads are free

  • Jobs created: 15 per day for each type
  • Running jobs: 2 per type
  • Downloads: 25 per day for each job
  • Request size: 4 MB (CSV, list or rows)

// faq

よくある質問

ほかにご質問がありますか? ヘルプセンターを見る

// 無料で始める

どの企業でも、Tomba が見つける人を確認

企業のドメインを入力すると、そこで働く人、その役職、検証済みの勤務先メールアドレスが、それぞれ見つかったページとともに表示されます。無料アカウント、カード不要です。