---
title: "Lancer une recherche entreprise"
method: POST
path: "/company-enrichment/search"
tags: ["Company Enrichment"]
---

# Lancer une recherche entreprise

`POST /company-enrichment/search`

## Request

- Base URL: `https://api.listar.fr`
- URL: `https://api.listar.fr/company-enrichment/search`
- Auth: HTTP bearer

Recherche entreprise **asynchrone** : firmographics + contacts (si `withContacts`). Réponse `202` avec un `id` ; récupérez le résultat via `GET /company-enrichment/search/{id}` ou par webhook (`callbackUrl`). Facturé à la complétion : **2 ct** si l’entreprise est trouvée + **5 ct par contact** retourné. `402` immédiat si le crédit ne couvre pas le coût max.

**Disponibilité : GA en France** (résolution d’identité sur registre officiel, dirigeants légaux inclus). **Alpha hors de France** : la résolution repose alors sur `domain`/`website` + `country`, la couverture des identifiants et des représentants légaux est partielle et le taux de match plus faible. Nous vous recommandons de tester un échantillon avant de lancer un volume hors France.

## Request body

- object: Au moins un critère requis : siren, siret, tva, domain, website ou companyName. ⚠️ `companyName` SEUL est ambigu (homonymes) : ajoutez `domain`/`website` - le signal d’identité le plus fort - et `country` si la société n’est pas française.
  - `siren` string
  - `siret` string
  - `tva` string
  - `domain` string: Signal d’identité le PLUS FIABLE : lève l’ambiguïté des homonymes et permet de résoudre les sociétés étrangères. À privilégier dès qu’il est connu.
  - `website` string
  - `companyName` string
  - `city` string
  - `country` string: Pays de la société (ex. `France`, `Belgium`). **Requis dès que la société n’est pas française.** La résolution par nom seul s’appuie sur le registre français : sans `country`, un nom étranger est résolu vers l’homonyme français (une « Altius » belge → la SARL française du même nom), et la recherche est facturée. Hors France, passez `country` ET `domain`/`website` comme ancre d’identité. Couverture : **GA en France**, **alpha ailleurs** (cf. description de l’endpoint).
  - `withFirmographics` boolean: Inclure (et facturer) les firmographics - infos société. Activé par défaut. Passez false pour ne payer/recevoir que les contacts (`withContacts:true` alors requis). Au moins un des deux (firmographics ou contacts) doit rester activé.
  - `withContacts` boolean: Inclure les contacts en plus des firmographics.
  - `contactsTargetCount` integer
  - `hintTitles` string: Intitulés de poste à privilégier parmi les contacts (texte libre, séparés par virgule / point-virgule / retour-ligne - ex. `DAF, DRH, responsable achats`). Oriente la sélection/catégorisation des contacts ; sans effet sur les firmographics.
  - `selectionInstructions` string: Consigne libre pour affiner la sélection des contacts de CETTE recherche (ex. « exclure les stagiaires et assistants », « prioriser les rôles techniques »). Affine par FONCTION/rôle uniquement (pas de filtre géographique). Les dirigeants légaux restent toujours inclus.
  - `contactHint` string: Contact ciblé pour CETTE entreprise (texte libre : nom et/ou rôle de la personne à prioriser, ex. `Nicolas Hernandez` ou `Directeur Général`). Si la personne est trouvée et confirmée dans l’entreprise, elle est renvoyée en premier, puis complétée par d’autres décideurs jusqu’au nombre cible ; sinon repli automatique sur les décideurs. Sans effet sur les firmographics.
  - `industry` string: Industrie / secteur de CETTE entreprise (texte libre, ex. `édition de logiciels`, `fonds d’investissement`). Sert à lever l’ambiguïté quand plusieurs sociétés portent le même nom : on privilégie celle dont l’activité correspond. Recommandé quand vous cherchez par NOM sans identifiant (SIREN/domaine).
  - `validatedOnly` boolean: ✅ Activé par défaut. N’affecte QUE les contacts (jamais les firmographics/infos société, toujours renvoyées). Si true (défaut), ne renvoie/facture que les contacts explicitement validés (les plus fiables). Cela EXCLUT les contacts non confirmés - vous pouvez donc obtenir moins de contacts. Passez false pour inclure aussi les contacts non confirmés.
  - `callbackUrl` string, uri: Webhook https notifié quand le résultat est prêt.

## Response `202`

Recherche lancée - poller GET /company-enrichment/search/{id}.

- object
  - `success` boolean
  - `id` string
  - `message` string

## Other responses

- `402`: Crédit insuffisant pour le coût max.
- `429`: Trop de requêtes (120 / min par clé API), ou 20 recherches déjà en cours pour ce compte : réessayer quand l’une d’elles se termine.

---

[API](https://skmtc.dev/listar/apis/listar-api.md) · [All operations](https://skmtc.dev/listar/apis/listar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/listar/apis/listar-api/revisions/d8b4a5e9acc8?raw)