// post /v1/bulk/similar
API similaire à un domaine en masse
Découvrez des sociétés similaires et des domaines concurrents pour des milliers de comptes en une seule tâche asynchrone.
Domains or company namesJusqu'à 5,000 lignes
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 · requête
Bulk Similar Domains tient en une requête HTTPS
Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.
- type
- similar
- list | data | file
- Domains or company names
- launch
- true lance la tâche immédiatement
- webhook_url
- Reçoit un événement signé à la fin de la tâche
- rows
- Jusqu'à 5,000 par tâche
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 · réponse
Ce qui est renvoyé
Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.
GET
/similarChampdata[].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
}
}Chaque ligne, telle que GET /similar la renvoie
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 · coût et limites
Ce que coûte un appel
Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.
// coût
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)
Créez une opération groupée en téléchargeant des domaines d'entreprise, puis lancez l'opération. L'API recherche des entreprises similaires pour chaque domaine de manière asynchrone en fonction de leur secteur d'activité, de leur taille et de leur modèle commercial.
Vous pouvez traiter jusqu'à 1 000 domaines par opération groupée. Chaque domaine renvoie une liste d'entreprises similaires.
L'API analyse plusieurs facteurs, notamment la classification industrielle, la taille de l'entreprise, le modèle commercial, la pile technologique et le positionnement sur le marché, pour identifier des entreprises similaires.
Chaque domaine renvoie une liste de domaines d'entreprise similaires avec leurs noms. Les résultats sont classés par pertinence et score de similarité.
Les cas d'utilisation courants incluent l'analyse concurrentielle, les études de marché, l'expansion du TAM, la recherche de sociétés similaires pour la prospection commerciale et la création de listes de comptes ciblées.
Le temps de traitement dépend de la taille de la liste et des recherches nécessaires. Interrogez le statut de la tâche ou configurez un webhook pour être averti de sa fin.
Oui, configurez une URL de webhook pour recevoir une notification lorsque votre opération de domaine similaire en masse se termine avec des résultats prêts à être téléchargés.
Une fois le traitement terminé, utilisez le point de terminaison de téléchargement pour obtenir tous les domaines similaires au format CSV ou JSON pour chaque domaine d'entrée.
Oui. Un flux de travail courant consiste à partir de clients connus, à rechercher des entreprises similaires en masse, puis à transmettre ces domaines à Domain Search ou Email Finder pour la découverte de contacts.
Utilisez des domaines d'entreprise officiels au lieu de microsites de produits ou de redirections de pays. Les domaines canoniques propres produisent un meilleur score de similarité et moins de doublons.