// post /v1/bulk/enrich
API zur Massen-E-Mail-Anreicherung
Verwandeln Sie rohe E-Mail-Listen mithilfe einer asynchronen API-Operation mit hohem Durchsatz in verwertbare Kontaktinformationen.
Email addressesBis zu 20,000 Zeilen
curl -X POST "https://api.tomba.io/v1/bulk/enrich" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Enrichment job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/enrich", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/enrich",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · anfrage
Massen-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.
- type
- enrich
- list | data | file
- Email addresses
- launch
- true startet den Job sofort
- webhook_url
- Erhält ein signiertes Ereignis, wenn der Job endet
- rows
- Bis zu 20,000 pro Job
curl -X POST "https://api.tomba.io/v1/bulk/enrich" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Enrichment job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/enrich", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/enrich",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
GET
/enrichFelddata.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)
POST /bulk/enrich
201 Created
{
"data": {
"id": 1042
}
}Jede Zeile, wie GET /enrich sie zurückgibt
200 OK
{
"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
1 search credit per row with a result. Plus 5 per row with phone data.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
Erstellen Sie einen Massenvorgang, indem Sie E-Mail-Adressen hochladen, und starten Sie dann den Vorgang. Die API reichert jede E-Mail asynchron mit Personen- und Unternehmensdaten an.
Sie können bis zu 10.000 E-Mail-Adressen pro Massenvorgang anreichern. Erstellen Sie für größere Datensätze mehrere Massenvorgänge.
Jede E-Mail wird mit Personendaten (Name, Titel, Standort, soziale Profile) und Unternehmensdaten (Name, Branche, Größe, Technologie-Stack, soziale Profile) angereichert.
Die Bearbeitungszeit hängt von der Größe der Liste und den nötigen Abfragen ab. Fragen Sie den Status des Jobs ab oder richten Sie einen Webhook ein, um zu erfahren, wann er abgeschlossen ist.
Jede E-Mail, die Anreicherungsdaten zurücksendet, zählt als 1 Anfrage. E-Mails, für die keine Daten gefunden wurden, werden nicht auf Ihr Kontingent angerechnet.
Ja, die Massenanreicherung gibt für jede E-Mail sowohl Daten auf Personenebene (Name, Rolle, soziale Profile) als auch Daten auf Unternehmensebene (Branche, Größe, Tech-Stack) zurück.
Ja, konfigurieren Sie eine Webhook-URL, um eine Benachrichtigung zu erhalten, wenn Ihr Massenanreicherungsvorgang abgeschlossen ist und die Ergebnisse zum Download bereitstehen.
Die Daten werden kontinuierlich aus öffentlichen Quellen aktualisiert. Jeder Datensatz enthält Zeitstempel, die angeben, wann die Daten zuletzt überprüft wurden.
Überprüfen Sie für Pipelines höchster Qualität zunächst Ihre Liste. Das Entfernen ungültiger E-Mails vor der Anreicherung trägt dazu bei, die Übereinstimmungsraten zu verbessern und nachgelagerte Arbeitsabläufe sauber zu halten.
Ja. Die meisten Teams verwenden den Massen-Download-Endpunkt und synchronisieren dann angereicherte Felder mit CRM, Marketingautomatisierung oder Warehouse-Pipelines.