// get /v1/combined/find
Combined API
Personen- und Firmendaten aus einer einzigen E-Mail-Adresse erhalten soziale Profile, Beschäftigung, Firmografien, Technologie-Stack und Geschäftskennzahlen in einem API-Aufruf. Ein direkter Clearbit Combined API-Ersatz.
2 search credits
// api-konsole
BeispielBeispielantwort aus der API-Referenz
- 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 · anfrage
Person + Company ist eine HTTPS-Anfrage
Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.
GET
/combined/findemailerforderlich- 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 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
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 · kosten und limits
Was ein Aufruf kostet
Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.
// kosten
2search credit
Berechnet, wenn: A person is returned.
Fehler, 429- und 451-Antworten sowie dieselbe Anfrage erneut innerhalb Ihres Nutzungsfensters kosten nichts.
So funktionieren Credits// rate limits
Anfragen pro Sekunde / Minute / Tag| 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 |
Seitlich scrollen, um alle Spalten zu sehen
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. Rate Limits
Eine einzelne Antwort mit Personendaten (Name, Standort, Beschäftigung, soziale Profile, Verifizierung) und Firmendaten (Firmografien, Technologie-Stack, WHOIS, SIC/NAICS, Kennzahlen, soziale Profile) für die E-Mail-Adresse.
Ja. Die Combined API ist ein direkter Ersatz für die Clearbit Combined Enrichment API. Eine E-Mail rein, Personen- + Firmendaten raus.
2 Such-Credits pro Abfrage, die eine Person liefert, für Person und Unternehmen in einem Aufruf. Abfragen, die niemanden finden, sind kostenlos.
Das Personenobjekt wird trotzdem zurückgegeben. Das Firmenobjekt ist null, wenn keine Firmendaten für die E-Mail-Domain verfügbar sind.
Person: LinkedIn, Twitter, GitHub, Facebook, Gravatar. Unternehmen: LinkedIn, Twitter, Facebook.
13 offizielle SDKs: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby und Rust.
Sowohl Personen- als auch Firmendatensätze enthalten indexedAt-Zeitstempel. Die Daten werden kontinuierlich aus unserem Crawl von 2B+ Webseiten monatlich aktualisiert.