// get /v1/phone-finder
电话查找 API
通过我们的 RESTful API，使用邮箱地址、公司域名或 LinkedIn 个人主页 URL 查找直接电话号码。
5 search credits
// api 控制台
示例API 参考中的示例响应
- valid
- true
- intl_format
- +1 650-555-0132
- line_type
- MOBILE
- carrier
- AT&T
- country_code
- US
- region.name
- California
- timezones
- 1 item
// 01 · 请求
Phone Finder只需一个 HTTPS 请求
使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。
GET
/phone-finderemailrichard@piedpiper.com- Work email
domainpiedpiper.com- Company domain: 1 search credit instead of 5
linkedinhttps://www.linkedin.com/in/richard-hendricks- LinkedIn profile URL
必填以下之一：email, domain, linkedin
curl -G https://api.tomba.io/v1/phone-finder \
--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/phone-finder?${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/phone-finder",
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
/phone-finderdataobject | array- The number; an array with full=true, and an empty array when none is found
data.validboolean | null- Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null- The number in international, E.164 and national formats
data.country_codestring | null- Country of the number (ISO code)
data.line_typestring | null- MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null- The network operator
data.region, data.timezonesobject | null, array | null- Where the number is registered, and its time zones
GET /phone-finder
200 OK· 5 search credits
{
"email": "richard@piedpiper.com",
"data": {
"email": "richard@piedpiper.com",
"valid": true,
"local_format": "(650) 555-0132",
"intl_format": "+1 650-555-0132",
"e164_format": "+16505550132",
"rfc3966_format": "tel:+1-650-555-0132",
"country_code": "US",
"line_type": "MOBILE",
"carrier": "AT&T",
"region": {
"name": "California",
"code": "CA"
},
"timezones": [
"America/Los_Angeles"
]
}
}// 03 · 费用和限制
调用的费用
仅在满足以下条件时才对调用收费。速率限制取决于您的套餐。
// 费用
5search credit
收费条件: A valid number is returned; 1 search credit instead of 5 when you search by domain.
错误、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 个人主页 URL。三种方式均可返回直接电话号码。
本地、国际、E.164 和 RFC3966 格式。附带国家代码、地区、类型、运营商和时区。
每次电话查找 10 个积分。包含在所有 Tomba 套餐中。
是的。不存储欧盟个人手机号码。仅限商务号码。
覆盖全球，在美国、英国、加拿大、澳大利亚和西欧效果最佳。提供 150 多个国家的企业电话号码。
两者都有。每条结果都包含号码类型（手机、座机、VoIP、免费电话），方便您按偏好的联系方式筛选。
可以。批量电话查找器 API 可通过上传 CSV 或批量 API 请求，一次处理数千次查询。
13 个官方 SDK：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby 和 Rust。