// get /v1/enrich
E-Mail-Enrichment API
Verwandeln Sie jede E-Mail-Adresse in ein vollständiges Kontakt- und Firmenprofil über unsere RESTful API.
1 search credit
// api-konsole
BeispielBeispielantwort aus der API-Referenz
- 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 · anfrage
Email Enrichment 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
/enrichemailerforderlich- 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 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
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 · 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
1search credit
Berechnet, wenn: An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
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
Vollständiger Name, Jobtitel, Abteilung, Seniorität, Land, Telefonnummer, LinkedIn, Twitter, GitHub, Firmenname, Branche, Größe, Standort, Technologie-Stack, E-Mail-Muster und Verifizierungsstatus.
Ja. Direkte Telefonnummern werden ohne zusätzliche Kosten zurückgegeben, wenn verfügbar.
Ja. Die Bulk-E-Mail-Enrichment API verarbeitet Tausende von E-Mails per CSV oder API.
Profile werden aus 2B+ monatlich gecrawlten Seiten kontinuierlich aktualisiert. Jeder Datensatz hat einen Zeitstempel der letzten Aktualisierung.
1 Credit pro Anreicherungsanfrage. Fehlgeschlagene Suchen nach unbekannten E-Mails werden nicht von Ihrem Kontingent abgezogen.
Ja. Jede Anreicherung enthält sowohl Personendaten (Name, Position, Social Media) als auch Unternehmensdaten (Name, Domain, Branche, Größe, Technologie-Stack).
13 offizielle SDKs: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby und Rust.
Ja. Die Antwortzeiten hängen vom Endpunkt ab und davon, wie schwer eine Adresse zu verifizieren ist. Setzen Sie daher ein großzügiges Timeout (die Dokumentation empfiehlt bis zu 180 Sekunden) und nutzen Sie für große Mengen Bulk-Jobs oder Webhooks.