// massenverarbeitung
Massen-Telefonvalidierung
Laden Sie eine CSV-Datei mit Telefonnummern hoch und validieren Sie alle hinsichtlich Format und Zustellbarkeit auf einmal.
- 01pending
POST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } } - 02running
launch: trueFortschritt abgefragt mit GET /v1/bulk/phone-validator/1042/progress - 03completed
bulk.completedsignierter Webhook an Ihre webhook_url zugestellt
GET /v1/bulk/phone-validator/1042/download?file=fullBerechnet beim ersten Download · der Job läuft nach 180 Tagen ab// 01 · eingabe
Die Eingabe eines Phone Validator-Massen-Jobs
Laden Sie in der App eine CSV-Datei mit bis zu 4 MB hoch oder senden Sie eine Liste, Zeilen oder eine Datei an POST /v1/bulk/phone-validator. Spalten werden anhand der Kopfzeile erkannt; legen Sie einen Feldindex fest, um selbst eine auszuwählen.
/bulk/phone-validatorSpaltenphone_field_index, country_field_index- Phone number, country
// 02 · api
Eine Anfrage startet den Job
Erstellen und starten Sie ihn mit einem Aufruf, verfolgen Sie dann den Fortschritt oder empfangen Sie ein signiertes bulk.completed-Ereignis. Jede Ergebniszeile entspricht dem, was GET /phone-validator zurückgibt.
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-validator", {
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": "Phone Validator job",
"list": "+16505550132",
"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/phone-validator",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Validator job",
"list": "+16505550132",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"valid": true,
"local_format": "(650) 555-0132",
"intl_format": "+1 650-555-0132",
"e164_format": "+16505550132",
"rfc3966_format": "tel:+1-650-555-0132",
"country_code": "US",
"line_type": "MOBILE",
"carrier": "AT&T",
"region": {
"name": "California",
"code": "CA"
},
"timezones": [
"America/Los_Angeles"
]
}
}// 03 · kosten und limits
Was ein Job kostet
Für das Erstellen oder Starten eines Jobs wird nichts berechnet. Seine Kosten werden einmalig beim ersten Download der Ergebnisse abgerechnet.
// abrechnung pro zeile
1 search credit per valid number.
Abrechnung von Massen-Jobs in der Dokumentation- Zeilen: bis zu 10,000 pro Job
- 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)
// 04 · überall nutzbar
Phone Validator-Jobs aus der App oder Ihrem Code ausführen
Derselbe Job, dieselben Credits: Laden Sie eine Datei in der App hoch, rufen Sie die API auf oder arbeiten Sie aus einer Tabelle oder einem No-Code-Tool.
- REST-APIJSON über HTTPS, 13 SDKs, signierte Webhooks.
GET /v1/phone-validator - Massen-CSVLaden Sie eine Liste in der App hoch oder senden Sie sie per POST an /bulk; laden Sie sie herunter, wenn sie fertig ist.
POST /v1/bulk/{type} - Zapier, Make, n8nNo-Code-Aktionen für Finder, Verifizierer und Anreicherung.
Zapier · Make · n8n · Pipedream
Die vollständige Anfrage-Referenz: /api/bulk/phone-validator
// kunden
Teams, die Phone Validator-Jobs ausführen
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation