// post /v1/bulk/similar
Bulk Domain Similar API
Vind vergelijkbare bedrijven en domeinen van concurrenten voor duizenden accounts in één asynchrone bulkjob.
Domains or company namesTot 5,000 rijen
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
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": "Similar Domains job",
"list": "piedpiper.com\nshopify.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/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · verzoek
Bulk Similar Domains 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
- similar
- list | data | file
- Domains or company names
- launch
- true start de taak meteen
- webhook_url
- Ontvangt een ondertekend event als de taak klaar is
- rows
- Tot 5,000 per taak
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
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": "Similar Domains job",
"list": "piedpiper.com\nshopify.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/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.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
/similardata[].website_urlstring- Each similar company's domain
data[].name, data[].industriesstring | null- Its name and industry
meta.total, meta.total_pagesinteger- Similar companies found, and pages
meta.current, meta.pageSizeinteger- This page and its size
meta.paramsobject- The parameters the search ran with
POST /bulk/similar
201 Created
{
"data": {
"id": 1042
}
}Elke rij, zoals GET /similar die teruggeeft
200 OK
{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 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
1 search credit per domain with at least one similar company.
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 bedrijfsdomeinen te uploaden en start de operatie. De API vindt asynchroon vergelijkbare bedrijven voor elk domein op basis van branche, omvang en bedrijfsmodel.
You can process up to 25,000 domains per bulk operation. Each domain returns a list of similar companies.
De API analyseert meerdere factoren, zoals brancheclassificatie, bedrijfsomvang, bedrijfsmodel, technologiestack en marktpositie, om vergelijkbare bedrijven te vinden.
Elk domein levert een lijst met domeinen van vergelijkbare bedrijven op, met hun namen. De resultaten zijn gerangschikt op relevantie en gelijkenisscore.
Veelvoorkomende toepassingen zijn concurrentieanalyse, marktonderzoek, TAM-uitbreiding, vergelijkbare bedrijven vinden voor salesprospectie en gerichte accountlijsten opbouwen.
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.
Ja, stel een webhook-URL in om een melding te krijgen zodra je bulkoperatie voor vergelijkbare domeinen klaar is en de resultaten klaarstaan om te downloaden.
Zodra de verwerking klaar is, haal je via het download-endpoint alle vergelijkbare domeinen per invoerdomein op als CSV of JSON.
Ja. Een gangbare werkwijze: begin bij bestaande klanten, vind in bulk vergelijkbare bedrijven en geef die domeinen daarna aan Domain Search of Email Finder om contacten te vinden.
Gebruik officiële bedrijfsdomeinen in plaats van productmicrosites of landredirects. Schone canonieke domeinen geven betere gelijkenisscores en minder duplicaten.