// reveal
描述您的 理想客户，获取匹配的公司
用日常语言描述您想要的公司。Reveal 列出匹配结果，包括行业、规模、城市，以及 Tomba 在每家公司掌握的邮箱数量。
// api 控制台
示例API 参考中的示例响应
- companies
- 1 item
- companies[0].name
- Pied Piper
- companies[0].website_url
- piedpiper.com
- companies[0].industry
- computer software
- companies[0].company_size
- 11-50
- companies[0].city
- Palo Alto
- companies[0].founded
- 2014
- companies[0].total_emails
- 48
// 这些公司的团队在使用 tomba
// 01 · 应用内
Tomba 应用中的 Reveal
在网页应用中描述您想要的公司：获取匹配结果、规模和地点，以及 Tomba 在每家公司掌握的邮箱数量。
// 02 · api
Reveal只需一个 HTTPS 请求
使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。
POST
/reveal/searchquery必填- What you are looking for, in plain language
page1- Result page
// 费用
各套餐速率限制1search credit
收费条件: At least one company is returned.
错误、429 和 451 响应，以及在用量窗口内重复的相同请求均不收费。
13 个官方 SDK： C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust. 文档中的库
POST /reveal/search
200 OK· 1 search credit
{
"success": true,
"data": {
"companies": [
{
"name": "Pied Piper",
"description": "Middle-out compression for files and video.",
"country": "US",
"state": "California",
"city": "Palo Alto",
"street_address": "5230 Newell Road",
"postal_code": "94303",
"industry": "computer software",
"company_size": "11-50",
"type": "privately held",
"founded": "2014",
"website_url": "piedpiper.com",
"total_emails": 48,
"revenue": "",
"phone_number": false,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"facebook_url": "",
"twitter_url": "",
"total_similar": 2
}
]
},
"meta": {
"total": 64,
"page": 1,
"limit": 10,
"pages": 7,
"filters": {
"location_state": {
"include": [
"California"
]
},
"industry": {
"include": [
"computer software"
]
}
}
}
}POST
/reveal/searchdata.companies[]array | null- Name, website, description, industry, size, type, founded, revenue, location, social links
data.companies[].total_emailsinteger- Addresses Tomba holds for the company
data.companies[].total_similarinteger- Similar companies Tomba knows
meta.total, meta.pagesinteger- Companies that match, and pages
meta.page, meta.limitinteger- This page and its size
meta.filtersobject- The filters Tomba read from your query
// 03 · 功能
从一句话到目标名单
Reveal 理解您的需求，返回可以直接跟进的公司。
自然语言搜索
直接搜索“法国 50 到 200 人的 B2B SaaS 公司”，无需设置筛选条件。
行业、规模和地点
每个匹配结果都显示行业、员工规模区间、城市和成立年份。
每家公司的联系人
查看 Tomba 在每家公司掌握的邮箱数量，然后在域名搜索中打开。
相似公司
从一个您满意的客户出发，找到与之相似的其他公司。
技术栈
查看公司使用的工具，从 CMS 到分析工具。
API 中的相同搜索
将同样的句子 POST 到 /reveal/search，并分页浏览匹配结果。
Tomba 从多个经过验证的来源汇聚数据，并交叉引用公司信息以确保高准确性。公司资料每月更新，技术数据每季度刷新。每个数据点都包含置信度指标。
Reveal 从公共网络来源、商业注册处、DNS 记录、WHOIS 数据库、社交媒体平台（在其服务条款范围内）、技术指纹识别和合作伙伴数据网络收集数据。所有收集均符合 GDPR、CCPA 和其他隐私法规。
每次公司 Reveal 查询消耗 1 个积分。如果未找到该域名的数据，则不消耗积分。批量查询成功返回结果时每个域名消耗 1 个积分。
可以。Reveal API 接受任何域名并返回完整的 JSON 公司资料。提供 JavaScript、Python、PHP、Ruby、Go 等官方 SDK。速率限制取决于您的方案级别。
是的。Tomba 仅处理公开可用的商务数据，尊重退出请求，实施数据最小化原则，并提供完全透明度。Reveal 不收集个人数据。
公司资料每月刷新。技术栈数据每季度更新。域名和 DNS 信息在每次查询时实时检查。社交资料每两周验证一次。
POST /reveal/search 在所有套餐中均支持每秒最多 5 次请求。每个响应都带有速率限制响应头；请参阅 速率限制。
可以。创建批量操作时配置 webhook URL。所有域名处理完毕后，Tomba 会发送一个 POST 通知，包含操作 ID 和结果摘要。