// get /v1/combined/find
コンバインド API
1つのメールアドレスからパーソンデータと企業データの両方を取得 ソーシャルプロフィール、勤務先、企業情報、テクノロジースタック、ビジネス指標を1回のAPI呼び出しで。Clearbit Combined APIの代替。
2 search credits
// api コンソール
例API リファレンスのレスポンス例
- person.name.fullName
- Richard Hendricks
- person.employment.title
- CEO
- person.verification.status
- valid
- company.name
- Pied Piper
- company.category.industry
- Internet Software & Services
- company.geo.city
- Palo Alto
- company.metrics.employees
- 11-50
- company.foundedYear
- 2014
// 01 · リクエスト
Person + Company は1回の HTTPS リクエストです
キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。
GET
/combined/findemail必須- Work email
curl -G https://api.tomba.io/v1/combined/find \
--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/combined/find?${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/combined/find",
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
/combined/finddata.personobject- Name, employment, location, social handles, verification (as in Person Enrichment)
data.person.employmentobject- Company, domain, title, role, seniority
data.companyobject- Name, industry codes, location, metrics, tech (as in Company Enrichment)
data.company.categoryobject- Sector, industry, SIC and NAICS codes
meta.emailstring- The address you sent
errorsobject- When nothing is found the response is still 200, with errors {type, message, code} instead of data
GET /combined/find
200 OK· 2 search credits
{
"data": {
"person": {
"name": {
"fullName": "Richard Hendricks",
"givenName": "Richard",
"familyName": "Hendricks"
},
"email": "richard@piedpiper.com",
"location": "Palo Alto, California, United States",
"gender": "male",
"timeZone": "America/Los_Angeles",
"utcOffset": -8,
"geo": {
"city": "Palo Alto",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US",
"lat": 37.4419,
"lng": -122.143
},
"bio": "Founder of Pied Piper.",
"site": "https://piedpiper.com",
"avatar": null,
"employment": {
"domain": "piedpiper.com",
"name": "Pied Piper",
"title": "CEO",
"role": "executive",
"subRole": null,
"seniority": "executive"
},
"facebook": {
"handle": null
},
"github": {
"handle": null,
"id": null,
"avatar": null,
"company": null,
"blog": null,
"followers": null,
"following": null
},
"twitter": {
"handle": null,
"id": null,
"bio": null,
"followers": null,
"following": null,
"statuses": null,
"favorites": null,
"location": null,
"site": null,
"avatar": null
},
"linkedin": {
"handle": "in/richard-hendricks"
},
"gravatar": {
"handle": null,
"urls": null,
"avatar": null,
"avatars": null
},
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone": true,
"fuzzy": false,
"emailProvider": "Google",
"indexedAt": "2025-01-15T10:32:00+01:00",
"activeAt": "2025-01-15T10:32:00+01:00",
"inactiveAt": null
},
"company": {
"name": "Pied Piper",
"legalName": "Pied Piper, Inc.",
"domain": "piedpiper.com",
"domainAliases": [],
"site": {
"phoneNumbers": [],
"emailAddresses": [
"hello@piedpiper.com"
]
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software & Services",
"industry": "Internet Software & Services",
"subIndustry": "Internet Software & Services",
"sicCode": "73",
"sic4Codes": [
"7372"
],
"naicsCode": "51",
"naics6Codes": [
"511210"
],
"naics6Codes2022": [
"513210"
]
},
"tags": [
"Compression",
"Decentralized internet"
],
"description": "Middle-out compression for files and video.",
"foundedYear": "2014",
"location": "5230 Newell Road, Palo Alto, CA 94303, United States",
"timeZone": "America/Los_Angeles",
"utcOffset": -8,
"geo": {
"streetNumber": "5230",
"streetName": "Newell Road",
"subPremise": null,
"streetAddress": "5230 Newell Road",
"city": "Palo Alto",
"postalCode": "94303",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US",
"lat": 37.4419,
"lng": -122.143
},
"logo": "https://logo.tomba.io/piedpiper.com",
"facebook": {
"handle": null,
"likes": null
},
"linkedin": {
"handle": "company/pied-piper"
},
"twitter": {
"handle": null,
"id": null,
"bio": null,
"followers": null,
"following": null,
"location": null,
"site": null,
"avatar": null
},
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"emailProvider": "Google",
"type": "private",
"ticker": null,
"identifiers": {
"usEIN": null
},
"metrics": {
"alexaUsRank": null,
"alexaGlobalRank": null,
"trafficRank": null,
"employees": "11-50",
"marketCap": null,
"raised": null,
"annualRevenue": null,
"estimatedAnnualRevenue": null,
"fiscalYearEnd": null
},
"indexedAt": "2025-01-15T10:32:00+01:00",
"tech": [
"google_apps",
"intercom"
],
"techCategories": [
"email_hosting_service",
"live_chat"
],
"parent": {
"domain": null
},
"ultimateParent": {
"domain": null
}
}
},
"meta": {
"email": "richard@piedpiper.com"
}
}// 03 · 料金と制限
呼び出しの料金
呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。
// レート制限
リクエスト数（秒／分／日）| 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. レート制限
メールアドレスに対するパーソンデータ（氏名、所在地、勤務先、ソーシャルプロフィール、認証）と企業データ（企業情報、テクノロジースタック、WHOIS、SIC/NAICS、指標、ソーシャルプロフィール）の両方を含む単一のレスポンス。
はい。コンバインドAPIはClearbit Combined Enrichment APIの代替です。1つのメールを入力すると、パーソン＋企業データが出力されます。
人物が見つかったルックアップ1回につき検索クレジット2つで、人物と企業の情報を1回の呼び出しで取得できます。誰も見つからなかったルックアップは無料です。
パーソンオブジェクトは引き続き返されます。メールドメインの企業データが利用できない場合、企業オブジェクトはnullになります。
パーソン：LinkedIn、Twitter、GitHub、Facebook、Gravatar。企業：LinkedIn、Twitter、Facebook。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。
パーソンと企業の両方のレコードにindexedAtタイムスタンプが含まれます。データは月間20億以上のウェブページのクロールから継続的に更新されます。