// post /v1/bulk/phone-finder
Bulk Phone Finder API
Zet grote contactbestanden om in bruikbare telefoonnummers met lijntype en provider, in één asynchrone job.
Email addresses, LinkedIn URLs or domainsTot 10,000 rijen
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 · verzoek
Bulk Phone Finder 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.
- type
- phone-finder
- list | data | file
- Email addresses, LinkedIn URLs or domains
- launch
- true start de taak meteen
- webhook_url
- Ontvangt een ondertekend event als de taak klaar is
- rows
- Tot 10,000 per taak
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 · antwoord
Wat je terugkrijgt
JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.
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
}
}Elke rij, zoals GET /phone-finder die teruggeeft
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 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
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)
Maak een bulkoperatie door e-mails, domeinen of LinkedIn-URL's te uploaden en start de operatie. De API vindt asynchroon telefoonnummers voor elk contact.
Je kunt tot 10.000 opzoekingen per bulkoperatie verwerken. Maak voor grotere datasets meerdere bulkoperaties.
Je kunt telefoonnummers vinden met e-mailadressen, bedrijfsdomeinen of LinkedIn-profiel-URL's. Geef één type per opzoeking op.
Elk resultaat bevat het telefoonnummer in meerdere formaten (lokaal, internationaal, E164), de landcode, het lijntype (mobiel, vast, VoIP), providergegevens en de tijdzone.
De verwerkingstijd hangt af van de grootte van de lijst en de opzoekingen die nodig zijn. Vraag de status van de taak op of stel een webhook in om te horen wanneer hij klaar is.
Elke opzoeking die een telefoonnummer oplevert, telt als 1 verzoek. Opzoekingen zonder gevonden nummer tellen niet mee voor je quotum.
Ja, stel een webhook-URL in om een melding te krijgen zodra je bulk phone finder-operatie klaar is en de resultaten klaarstaan om te downloaden.
De Phone Finder API levert telefoongegevens voor meer dan 100 landen wereldwijd, correct internationaal opgemaakt.
Ja. Stuur de resultaten na een bulk phone finder-run naar Bulk Phone Validator om geldigheid, lijntype en bereikbaarheid te bepalen.
Verwijder duplicaten, normaliseer domeinen en zorg dat profielen en e-mails geldig en volledig zijn. Schone invoer verhoogt het matchpercentage en voorkomt verspilde verzoeken.