// get /v1/combined/find
Gecombineerde API
Krijg zowel persoons- als bedrijfsgegevens van één e-mailadres sociale profielen, dienstverband, firmografie, technologiestack en bedrijfsstatistieken in één API-aanroep. Een directe Clearbit Combined API-vervanging.
2 search credits
// api-console
VoorbeeldVoorbeeldantwoord uit de API-naslag
- 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 · verzoek
Person + Company is één HTTPS-verzoek
Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.
GET
/combined/findemailverplicht- 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 · antwoord
Wat je terugkrijgt
JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.
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 en limieten
Wat een aanroep kost
Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.
// kosten
2search credit
In rekening gebracht als: A person is returned.
Fouten, 429- en 451-antwoorden en hetzelfde verzoek opnieuw binnen je gebruiksvenster kosten niets.
Hoe credits werken// rate limits
Verzoeken per seconde / minuut / dag| 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 |
Scroll opzij voor alle kolommen
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
Eén antwoord met zowel persoonsgegevens (naam, locatie, dienstverband, sociale profielen, verificatie) als bedrijfsgegevens (firmografie, technologiestack, WHOIS, SIC/NAICS, statistieken, sociale profielen) voor het e-mailadres.
Ja. De Gecombineerde API is een directe vervanging voor de Clearbit Combined Enrichment API. Eén e-mail erin, persoons- + bedrijfsgegevens eruit.
2 zoekcredits per opzoeking die een persoon oplevert, voor de persoon en het bedrijf in één aanroep. Opzoekingen die niemand vinden zijn gratis.
Het persoonsobject wordt nog steeds geretourneerd. Het bedrijfsobject is null als er geen bedrijfsgegevens beschikbaar zijn voor het e-maildomein.
Persoon: LinkedIn, Twitter, GitHub, Facebook, Gravatar. Bedrijf: LinkedIn, Twitter, Facebook.
13 officiële SDK's: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby en Rust.
Zowel persoons- als bedrijfsrecords bevatten indexedAt-tijdstempels. Gegevens worden continu bijgewerkt vanuit onze crawl van 2B+ webpagina's per maand.