域名搜索返回哪些数据？

每次请求返回：该域名的所有已知邮箱地址，每个邮箱附带全名、职位、部门、级别、国家、LinkedIn URL、电话号码、可信度评分、验证状态、邮箱格式、来源 URL 和时间戳。公司数据包括行业、规模、位置、社交资料和技术栈。

有哪些筛选选项？

您可以按部门（管理层、市场营销、人力资源、IT、销售、工程、财务等）、级别（高级、初级、管理层）、邮箱类型（个人或通用）、国家代码和验证状态进行筛选。

是否包含电话号码？

是的。可用时会返回每位员工的电话号码，包括号码类型（手机、座机、免费电话）、国家和格式。域名搜索结果中的电话数据不额外收费。

分页如何工作？

结果分页显示，每次请求最多 10 个邮箱。使用 page 参数进行翻页。元数据对象包含总数和分页详情。1 积分 = 1 页最多 10 条结果。

速率限制是多少？

限制按计划和端点设定，单位为每秒 / 每分钟 / 每天的请求数：Free 1 / 2 / 5，Basic 3 / 50 / 500，Growth 5 / 80 / 1,000，Pro 8 / 150 / 4,000。Pro Plus 和 Scale 不设限制，Enterprise 每天允许 100,000 个请求，且无每秒限制。每个响应都包含速率限制头；请参阅速率限制。对于大型列表，请使用批量域名搜索：每个任务最多 25,000 个域名。

来源如何追踪？

每个邮箱包含一个来源数组，其中包含发现该邮箱的 URL、提取日期、最后发现日期，以及该邮箱是否仍然可见。这有助于验证数据的新鲜度和可靠性。

是否返回公司社交资料？

是的。响应中包含 LinkedIn 公司页面、Twitter 账号、Facebook 页面和其他社交资料（如果可用），以及公司描述和行业分类。

能否按国家筛选？

是的。传入两位字母的国家代码（如 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只需一个 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. 速率限制

// 常见问题