ドメイン検索はどのようなデータを返しますか？

各リクエストは以下を返します：ドメインの既知のメールアドレスすべて（各アドレスにフルネーム、役職、部門、役職レベル、国、LinkedIn URL、電話番号、信頼度スコア、検証ステータス、メールパターン、ソースURL、タイムスタンプ付き）。企業データには業種、規模、所在地、ソーシャルプロフィール、テクノロジースタックが含まれます。

どのようなフィルタリングオプションがありますか？

部門（エグゼクティブ、マーケティング、人事、IT、営業、エンジニアリング、財務など）、役職レベル（シニア、ジュニア、エグゼクティブ）、メールタイプ（個人または一般）、国コード、検証ステータスでフィルタリングできます。

電話番号は含まれますか？

はい。利用可能な場合、各従業員の電話番号が返されます。番号のタイプ（携帯、固定、フリーダイヤル）、国、フォーマットを含みます。ドメイン検索結果の電話データに追加クレジットは不要です。

ページネーションはどのように機能しますか？

1リクエストあたり最大10件のメールでページネーション。pageパラメータでナビゲーション。メタオブジェクトに合計数とページネーション詳細を含みます。1クレジット = 最大10件の1ページ。

レート制限はどのくらいですか？

制限はプランとエンドポイントごとに、毎秒/毎分/毎日のリクエスト数で設定されています：Free 1 / 2 / 5、Basic 3 / 50 / 500、Growth 5 / 80 / 1,000、Pro 8 / 150 / 4,000。Pro PlusとScaleは無制限で、Enterpriseは毎秒の制限なしで1日100,000リクエストまで利用できます。すべてのレスポンスにレート制限ヘッダーが含まれます。詳しくはレート制限をご覧ください。大量のリストにはバルクドメイン検索をご利用ください。1ジョブあたり最大25,000ドメインを処理できます。

ソースはどのように追跡されますか？

各メールには、発見されたURLのソース配列、抽出日、最終確認日、メールがまだ表示されているかどうかが含まれます。これによりデータの鮮度と信頼性を検証できます。

企業のソーシャルプロフィールは返されますか？

はい。レスポンスには、利用可能な場合、LinkedIn企業ページ、Twitterハンドル、Facebookページ、その他のソーシャルプロフィールが含まれます。企業説明と業種分類も併せて返されます。

国でフィルタリングできますか？

はい。2文字の国コード（例：US、FR、DE）をクエリパラメータとして渡すと、その国にいる従業員のみを取得できます。この機能は2025年6月のアップデートで追加されました。

// get /v1/domain-search

ドメイン検索 API

任意の企業ドメインに関連するすべてのメールアドレス、電話番号、企業情報、従業員プロフィールを検索。部門、役職レベル、国などでフィルタリング可能。

無料 API キーを取得 API リファレンス

1 search credit per 10 results

// api コンソール

例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 · リクエスト

Domain Search は1回の HTTPS リクエストです

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

GET/domain-search

domainpiedpiper.com: Company domain (or send company)
limit10: Results per page, from 1 to 5,000 (at most 10 on the Free plan)
departmentengineering: Filter by team
countryUS: Filter by country

GET /domain-search

curl -G https://api.tomba.io/v1/domain-search \
  --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/domain-search?${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/domain-search",
    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/domain-search

data.organizationobject: Company name, location, social links, industry, size, revenue, description, pattern
data.organization.accept_allboolean: The domain accepts mail for any address (catch-all)
data.emails[].emailstring: Each address found
data.emails[].full_name, data.emails[].position, data.emails[].departmentstring | null: Name, job title and team
data.emails[].senioritystring | null: junior, senior or executive
data.emails[].scoreinteger: Confidence from 0 to 100
data.emails[].verification.statusstring | null: valid, accept_all, invalid or unknown, with verification.date
data.emails[].sources[]array: Where each address was found
meta.total, meta.total_pagesinteger: Addresses that match, and pages at this pageSize
meta.current, meta.pageSizeinteger: This page and its size
meta.paramsobject: The parameters the search ran with

GET /domain-search

200 OK· 1 search credit per 10 results

{
  "data": {
    "organization": {
      "website_url": "piedpiper.com",
      "organization": "Pied Piper",
      "location": {
        "country": "US",
        "city": "Palo Alto",
        "state": "CA",
        "street_address": "5230 Newell Road",
        "postal_code": "94303"
      },
      "social_links": {
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": null,
        "linkedin_url": "https://www.linkedin.com/company/pied-piper",
        "github_url": null,
        "youtube_url": null,
        "pinterest_url": null,
        "tiktok_url": null
      },
      "disposable": false,
      "webmail": false,
      "phone_number": false,
      "industries": "computer software",
      "founded": "2014",
      "company_size": "11-50",
      "company_type": "privately held",
      "revenue": null,
      "accept_all": false,
      "description": "Middle-out compression for files and video.",
      "pattern": "{first}",
      "total_similar": 2,
      "keywords": [
        "compression",
        "middle-out",
        "decentralized internet"
      ],
      "ranking": null,
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "last_updated": "2025-01-15T10:32:00+01:00"
    },
    "emails": [
      {
        "email": "dinesh@piedpiper.com",
        "first_name": "Dinesh",
        "last_name": "Chugtai",
        "full_name": "Dinesh Chugtai",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Software Engineer",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 99,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "sources": [
          {
            "uri": "https://piedpiper.com/blog/engineering",
            "website_url": "piedpiper.com",
            "extracted_on": "2024-06-01T09:14:07+01:00",
            "last_seen_on": "2025-01-10T17:02:44+01:00",
            "still_on_page": true
          }
        ]
      },
      {
        "email": "gilfoyle@piedpiper.com",
        "first_name": "Bertram",
        "last_name": "Gilfoyle",
        "full_name": "Bertram Gilfoyle",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Systems Architect",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 97,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "sources": [
          {
            "uri": "https://piedpiper.com/blog/engineering",
            "website_url": "piedpiper.com",
            "extracted_on": "2024-06-01T09:14:07+01:00",
            "last_seen_on": "2025-01-10T17:02:44+01:00",
            "still_on_page": true
          }
        ]
      }
    ]
  },
  "meta": {
    "total": 12,
    "pageSize": 10,
    "current": 1,
    "total_pages": 2,
    "params": {
      "domain": "piedpiper.com",
      "company": "",
      "page": 1,
      "limit": 10,
      "department": "engineering",
      "country": null,
      "type": "all",
      "live": false,
      "enrich_mobile": false,
      "webhook_url": null
    }
  }
}

// 03 · 料金と制限

呼び出しの料金

呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。

// 料金

1 per 10search credit

課金条件: At least one address is 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. レート制限

// faq