Company Enrichment

Lancer une recherche entreprise

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.

post/company-enrichment/search

Request

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

Request body

sirenstring
siretstring
tvastring
domainstring

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.

websitestring
companyNamestring
citystring
countrystring

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).

withFirmographicsboolean

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é.

withContactsboolean

Inclure les contacts en plus des firmographics.

contactsTargetCountinteger
hintTitlesstring

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.

selectionInstructionsstring

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.

contactHintstring

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.

industrystring

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).

validatedOnlyboolean

✅ 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.

callbackUrlstring uri

Webhook https notifié quand le résultat est prêt.

Response

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

successboolean
idstring
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.