跳到主要内容
Tomba 首页
免费开始

// 开发者平台

强大的邮箱智能 API

将邮箱查找、验证和数据丰富功能集成到您的应用程序中。RESTful API 支持所有主流编程语言的 SDK。

获取免费 API 密钥API 参考
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
GETapi.tomba.io/v1/domain-search
示例
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 · 端点

每个端点、其费用及参考页面

基于 HTTPS 的 REST，JSON 输入输出，两个请求头用于认证。基础 URL 为 https://api.tomba.io/v1。

GET/email-finderA person's work email from their name and company domain费用:1 search credit收费条件:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profile费用:1 search credit per 10 results收费条件:At least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checks费用:1 verification credit收费条件:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profiles费用:1 search credit收费条件:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URL费用:1 search credit收费条件:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an article费用:1 search credit收费条件:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URL费用:5 search credits收费条件:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and region费用:1 search credit收费条件:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filters费用:1 search credit收费条件:At least one company is returned.
GET/combined/findThe person and their company from one email address费用:2 search credits收费条件:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socials费用:1 search credit收费条件:A company is returned.
GET/technologyThe technologies a website runs, by category费用:Free收费条件:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniority费用:1 email count credit收费条件:Every call.
GET/similarCompanies similar to a domain, with their industry费用:1 search credit per 10 results收费条件:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their share费用:1 email count credit收费条件:Every successful call, including an empty result.
GET/locationWhere a company's people are, by country费用:1 email count credit收费条件:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handles费用:1 search credit收费条件:A person is returned.
基础 URL https://api.tomba.io/v1 · 每个请求都需发送 X-Tomba-Key 和 X-Tomba-Secret。API 参考中的所有端点

// 02 · 批量

最多 25,000 行列表的批量任务

将列表、行或 CSV 通过 POST 发送到 /bulk/，结束时接收已签名的 webhook，并在首次下载时一次性付费。

批量类型输入最大行数
POST/bulk/searchDomains or company names25,000
POST/bulk/similarDomains or company names5,000
POST/bulk/companyDomains or company names25,000
POST/bulk/finderNames, with a domain or company name10,000
POST/bulk/enrichEmail addresses20,000
POST/bulk/linkedinLinkedIn profile URLs20,000
POST/bulk/authorArticle URLs5,000
POST/bulk/verifierEmail addresses20,000
POST/bulk/phone-finderEmail addresses, LinkedIn URLs or domains10,000
POST/bulk/phone-validatorPhone numbers, with an optional country10,000

横向滚动可查看所有列

// 03 · 速率限制

各套餐的吞吐量

限制按账户计算，涵盖其所有密钥。批量任务有各自的限制。

// 速率限制

每秒 / 每分钟 / 每天请求数
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 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. 速率限制

// 04 · sdk 和工具

13 个 SDK、一个 CLI 和一个 MCP 服务器

官方库封装了相同的端点；CLI 和 MCP 服务器使用您的密钥或 OAuth。

// 常见问题

API常见问题

还有其他问题？ 访问帮助中心

// 快速入门

一分钟内完成首次调用

免费账户、真实的 API 密钥，与 Enterprise 客户使用相同的端点。

  1. 01创建免费账户每 30 天 25 个搜索积分。无需信用卡。
  2. 02复制您的密钥和密钥密码在控制台的 API 密钥页面获取。
  3. 03调用 API粘贴请求；返回结果为 JSON。
获取免费 API 密钥阅读文档
curl -G https://api.tomba.io/v1/email-finder \
  --data-urlencode "domain=piedpiper.com" \
  --data-urlencode "first_name=Richard" \
  --data-urlencode "last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
响应
200 OK
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "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
      }
    ],
    "phone_data": []
  }
}