// api 控制台
示例API 参考中的示例响应
- richard@piedpiper.com
- full_name
- Richard Hendricks
- position
- CEO
- company
- Pied Piper
- score
- 100
- verification.status
- valid
- phone_number
- true
- accept_all
- false
- sources
- 1 item
// 01 · 请求
Email Enrichment只需一个 HTTPS 请求
使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。
GET
/enrichemail必填- The address to enrich
enrich_mobilefalse- Also return phone numbers
curl -G https://api.tomba.io/v1/enrich \
--data-urlencode "email=richard@piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
email: "richard@piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/enrich?${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/enrich",
params={
"email": "richard@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
/enrichdata.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.company, data.website_urlstring | null- The company and its domain
data.disposable, data.webmailboolean- The address is on a disposable or webmail domain
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
GET /enrich
200 OK· 1 search credit
{
"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
}
],
"disposable": false,
"webmail": false,
"phone_data": []
}
}// 03 · 费用和限制
调用的费用
仅在满足以下条件时才对调用收费。速率限制取决于您的套餐。
// 费用
1search credit
收费条件: An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
错误、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. 速率限制
全名、职位、部门、级别、国家、电话号码、LinkedIn、Twitter、GitHub、公司名称、行业、规模、位置、技术栈、邮箱格式和验证状态。
是的。可用时返回直接电话号码，不额外收费。
是的。批量邮箱数据丰富 API 通过 CSV 或 API 处理数千个邮箱。
资料从每月爬取的 20 亿+ 页面中持续更新。每条记录都有最后更新时间戳。
每次数据丰富请求消耗 1 积分。针对未知邮箱的失败查询不计入您的配额。
会。每次数据丰富都同时包含人员数据（姓名、职位、社交资料）和公司数据（名称、域名、行业、规模、技术栈）。
13 个官方 SDK：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby 和 Rust。
能。响应时间因端点以及地址的验证难度而异，因此请设置较宽松的超时时间（文档建议最长 180 秒），大批量数据请使用批量任务或 webhook。