// post /v1/bulk/phone-finder
Bulk Phone Finder-API
Lösen Sie große Kontaktdatensätze in verwendbare Telefonnummern mit Leitungstyp- und Netzbetreiber-Metadaten in einem asynchronen Job auf.
Email addresses, LinkedIn URLs or domainsBis zu 10,000 Zeilen
curl -X POST "https://api.tomba.io/v1/bulk/phone-finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Finder job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-finder", {
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 Finder 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/phone-finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Finder job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · anfrage
Massen-Phone Finder 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
- phone-finder
- list | data | file
- Email addresses, LinkedIn URLs or domains
- launch
- true startet den Job sofort
- webhook_url
- Erhält ein signiertes Ereignis, wenn der Job endet
- rows
- Bis zu 10,000 pro Job
curl -X POST "https://api.tomba.io/v1/bulk/phone-finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Finder job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-finder", {
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 Finder 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/phone-finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Finder 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
/phone-finderdataobject | array- The number; an array with full=true, and an empty array when none is found
data.validboolean | null- Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null- The number in international, E.164 and national formats
data.country_codestring | null- Country of the number (ISO code)
data.line_typestring | null- MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null- The network operator
data.region, data.timezonesobject | null, array | null- Where the number is registered, and its time zones
POST /bulk/phone-finder
201 Created
{
"data": {
"id": 1042
}
}Jede Zeile, wie GET /phone-finder sie zurückgibt
200 OK
{
"email": "richard@piedpiper.com",
"data": {
"email": "richard@piedpiper.com",
"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 Aufruf kostet
Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.
// kosten
5 search credits per row with at least one phone number.
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-Mails, Domänen oder LinkedIn-URLs hochladen, und starten Sie dann den Vorgang. Die API findet asynchron Telefonnummern für jeden Kontakt.
Sie können bis zu 10.000 Suchvorgänge pro Massenvorgang verarbeiten. Erstellen Sie für größere Datensätze mehrere Massenvorgänge.
Sie können Telefonnummern mithilfe von E-Mail-Adressen, Unternehmensdomänen oder LinkedIn-Profil-URLs finden. Geben Sie einen Typ pro Suche an.
Jedes Ergebnis umfasst die Telefonnummer in mehreren Formaten (lokal, international, E164), die Landesvorwahl, den Leitungstyp (Mobilfunk, Festnetz, VoIP), Anbieterinformationen und die Zeitzone.
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 Suche, die eine Telefonnummer zurückgibt, zählt als 1 Anfrage. Suchvorgänge, bei denen kein Telefon gefunden wurde, werden nicht auf Ihr Kontingent angerechnet.
Ja, konfigurieren Sie eine Webhook-URL, um eine Benachrichtigung zu erhalten, wenn Ihr Bulk Phone Finder-Vorgang mit zum Download bereitstehenden Ergebnissen abgeschlossen wird.
Die Phone Finder API stellt Telefondaten für über 100 Länder weltweit mit korrekter internationaler Formatierung bereit.
Ja. Senden Sie nach einem Bulk Phone Finder-Lauf die Ergebnisse an den Bulk Phone Validator, um Gültigkeit, Leitungstyp und Zustellbarkeitszuverlässigkeit zu klassifizieren.
Entfernen Sie Duplikate, normalisieren Sie Domänen und stellen Sie sicher, dass Profil-/E-Mail-Werte gültig und vollständig sind. Saubere Eingaben verbessern die Übereinstimmungsraten und reduzieren verschwendete Anfragen.