Aller au contenu

// 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"}'

// 01 · requête

Similar Domains en masse 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"}'

// 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/similar
data[].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)

// faq

Foire aux questions

D'autres questions ? Consultez le centre d'aide

// commencer gratuitement

Découvrez qui Tomba trouve dans n'importe quelle entreprise

Saisissez le domaine d'une entreprise pour voir ses collaborateurs, leurs fonctions et leurs emails professionnels vérifiés, chacun avec les pages où il a été trouvé. Compte gratuit, sans carte.