search_companies
Recherche d'entreprises francaises par nom, SIREN/SIRET, activite ou criteres (geographie, secteur, effectif, financier, dirigeants, groupe). Pour une societe citee par son nom : trouver le SIREN ici, puis get_company ou get_financials. Effectif et statut departagent les homonymes.
Le siren est dans chaque resultat : ne pas les repasser par resolve_companies (fiches sans identifiant).
Valeurs : un chiffre (ca, ebitda, resultat_net, effectif_moyen, signaux publics...) n'est retourne que s'il figure dans include_fields, meme quand il sert de filtre. 3 champs par recherche (free), 10 (pro). Un nom inconnu est liste dans include_fields_unknown : le corriger plutot que d'appeler get_company ligne par ligne. get_financials sert l'historique multi-annees.
Filtres simples au premier niveau, les deux bornes cote a cote (effectif_min et effectif_max ; idem ca, resultat_net, tresorerie, cagr_ca, date_creation, age_dirigeant). Criteres avances (ratios, CAGR, bilan, delais, signaux publics, fonds, CAC, comptes) dans advanced_filters ; une cle inconnue est rejetee (400).
Groupe : siren_groupe (valeur donnee par get_company) liste toutes les societes du groupe.
Dirigeant : dirigeant_nom + dirigeant_prenom (+ dirigeant_naissance). Inclut les dirigeants remontes via une personne morale ; mandats directs d'une personne : search_director_companies.
Tri : sort_by (relevance, chiffre_affaires, resultat_net, effectif_moyen, date_creation, capital) et sort_order.
Cessions : include_fields=nb_cessions,derniere_cession_date signale les societes a lire dans get_events.
20 resultats par defaut, max 20 (free) ou 100 (pro) ; pagination par cursor sur Pro. COUT : 1 appel de quota par tranche de 20 lignes servies ; la reponse donne _user_plan et le quota restant. Pour suivre la recherche dans le temps : create_saved_search.
Retourne l'identite de base de chaque societe (siren, denomination, NAF, localisation, effectif, statut) + include_fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Nombre de resultats par page (defaut 20 ; max 20 sur free, 100 sur pro). Facture 1 appel de quota par tranche de 20 lignes : limit=100 coute 5 appels. | |
| query | Yes | Nom, SIREN, mot-cle activite, ou "*" pour rechercher uniquement par filtres. Operateurs acceptes : "expression exacte", OR en majuscules (ou |) entre deux termes, -terme pour exclure, parentheses pour grouper. Ex : (logiciel OR saas) "gestion de paie" -holding | |
| ville | No | Nom de ville. Plusieurs villes separees par virgule. Ex: "Paris,Lyon,Bordeaux" | |
| ca_max | No | CA maximum en euros. Ex: 50000000 pour 50M | |
| ca_min | No | CA minimum en euros. Ex: 5000000 pour 5M | |
| cursor | No | Curseur de pagination retourne dans next_cursor de la reponse precedente. Ne pas fournir pour la premiere page. | |
| radius | No | Rayon de recherche en km (1-200) autour de latitude/longitude. Les trois vont ensemble : un triplet incomplet est refuse. | |
| region | No | Region. Ex: "Ile-de-France", "Bretagne", "Auvergne-Rhone-Alpes" | |
| statut | No | Filtre par statut au registre. DISSOLVED = dissoute ou radiee ; une societe en procedure collective reste ACTIVE jusqu'a sa radiation. Le statut ne se deduit PAS de date_radiation, absente sur environ 9,9M des 12,4M societes dissoutes. | |
| sort_by | No | Tri des resultats. Par defaut "relevance". Ex: "chiffre_affaires" pour trier par CA. | |
| code_naf | No | Code NAF/APE. Exemples courants : - SaaS/Logiciel : 5829C, 6201Z, 6202A - Conseil IT : 6202A, 6209Z - Conseil management : 7022Z - Fintech : 6419Z, 6499Z - Biotech/Pharma : 2120Z, 7211Z - E-commerce : 4791A, 4791B - BTP : 4120A, 4120B - Restauration : 5610A, 5610C Plusieurs codes separes par virgule. | |
| is_cotee | No | true pour les societes cotees en bourse uniquement, false pour les exclure | |
| latitude | No | Latitude du centre pour une recherche par rayon (WGS84). A fournir avec longitude ET radius. | |
| longitude | No | Longitude du centre pour une recherche par rayon (WGS84). A fournir avec latitude ET radius. | |
| sort_order | No | Ordre de tri. Par defaut "desc". Ex: "asc" pour les plus petits CA en premier. | |
| cagr_ca_max | No | Croissance CA max sur 1 an en % (ex: 50 pour +50%) | |
| cagr_ca_min | No | Croissance CA min sur 1 an en % (ex: 20 pour +20%) | |
| code_postal | No | Code postal du siege. Ex: "75001", "69001". Plusieurs separes par virgule. | |
| departement | No | Code departement. Ex: "75", "33", "69" | |
| est_filiale | No | true = filiales uniquement, false = entreprises independantes uniquement | |
| has_website | No | true pour ne retourner que les entreprises ayant un site web | |
| credit_grade | No | Grades de risque credit a garder (OR). Ex: ["CCC","D"] pour les societes a risque eleve, ["AAA","AA"] pour les plus solides. ~900k societes scorees (celles avec un bilan recent) ; les non scorees sont exclues des qu'un grade est demande. | |
| effectif_max | No | Effectif maximum (nombre de salaries) | |
| effectif_min | No | Effectif minimum (nombre de salaries) | |
| filter_annee | No | Annee de l'exercice financier. Filtre les entreprises dont le dernier bilan publie correspond a cette annee. Ex: 2024 pour ne voir que les bilans 2024. Combiner avec ca_min pour "societes ayant fait 5M de CA en 2024". | |
| siren_groupe | No | SIREN de la tete de groupe. Retourne toutes les societes du meme groupe. Ex: "352383715" pour lister toutes les filiales de LVMH. | |
| credit_scored | No | true pour ne garder que les societes qui ont un score credit, false pour les exclure | |
| dirigeant_nom | No | Nom de famille du dirigeant (recherche exacte). Ex: "GUILLEMOT". Combine avec dirigeant_prenom et dirigeant_naissance pour desambiguiser les homonymes. | |
| groupe_parent | No | Nom du groupe parent (recherche textuelle). Ex: "LVMH", "Bouygues" | |
| plan_en_cours | No | Societes executant un plan (redressement, sauvegarde ou cession). Distinct de procedure_collective : sous plan, la periode d'observation est terminee. | |
| include_fields | No | Champs a ajouter a chaque resultat (CSV). Une valeur filtree n'apparait que si son champ est demande. Montants et ratios : le champ porte le nom du filtre sans _min/_max (ebitda_min -> ebitda, capitaux_propres_min -> capitaux_propres, nb_cessions_min -> nb_cessions). Exceptions : dividendes_min -> dividendes_verses ; nb_marches_min -> nb_marches_titulaire,montant_marches_titulaire ; nb_subventions_min -> nb_subventions,montant_subventions_total ; nb_brevets_min -> nb_brevets,nb_brevets_actifs. Financier : ca, marge_brute, valeur_ajoutee, ebitda, resultat_exploitation, resultat_net, marge_nette, marge_ebitda, total_actif, capitaux_propres, tresorerie, dettes_financieres, dettes_fournisseurs, dette_nette, bfr, ratio_endettement, capacite_autofinancement, dividendes_verses, delai_paiement_clients_jours, delai_paiement_fournisseurs_jours, effectif_moyen, annee_financiere. Croissance : croissance_ca, croissance_ebitda, croissance_rn, et leurs variantes _2ans, _3ans, _5ans. Groupe : est_filiale, est_tete_de_groupe, groupe_parent, siren_groupe, nb_filiales_directes, societe_mere_etrangere. Signaux BODACC : nb_cessions, derniere_cession_date, a_fusionne, nb_modifications_capital, nb_transferts_siege, nb_changements_denomination, nb_evt_modif_admin. Donnees publiques : nb_marches_titulaire, montant_marches_titulaire, nb_subventions, montant_subventions_total, nb_brevets, nb_brevets_actifs, nb_participations_salons, est_societe_mission, est_ess. Fonds PE/VC : a_fonds, nom_fonds, siren_fonds, type_fonds, annee_entree_fonds, nb_fonds_actuels. Cotees : a_lei, lei, source_esef, source_gleif, nb_instruments_financiers. Compteurs et fraicheur : nb_dirigeants, nb_etablissements, nb_representants_actifs, derniere_evt_date, dernier_depot_date, dernier_marche_date. Texte : description_activite (alias description ; reprend souvent le libelle NAF), objet_social, site_internet (~40 % des societes a CA > 8 M EUR). Le descriptif est deja cherche par query. Plan gratuit : ca, resultat_net, effectif_moyen, croissance_ca, annee_financiere, plus les champs groupe, signaux, donnees publiques et texte. | |
| tresorerie_max | No | Tresorerie maximum en euros | |
| tresorerie_min | No | Tresorerie minimum en euros | |
| advanced_filters | No | ||
| dirigeant_prenom | No | Prenom du dirigeant. A utiliser avec dirigeant_nom. Ex: "Yves" | |
| resultat_net_max | No | Resultat net maximum en euros | |
| resultat_net_min | No | Resultat net minimum en euros | |
| age_dirigeant_max | No | Age maximum des dirigeants (annees). Ex: 50 pour moins de 50 ans. Filtre si au moins un dirigeant correspond. | |
| age_dirigeant_min | No | Age minimum des dirigeants (annees). Ex: 60 pour 60 ans et plus. Filtre si au moins un dirigeant correspond. | |
| appartient_groupe | No | true = uniquement les societes appartenant a un groupe : filiales declarees OU soupcon de groupe fort (groupe_pont probable). Complement exact de independant_strict (ne pas envoyer les deux en meme temps). | |
| date_creation_max | No | Date de creation maximum (ISO). Ex: "2021-12-31" pour les entreprises creees avant 2022 | |
| date_creation_min | No | Date de creation minimum (ISO). Ex: "2021-01-01" pour les entreprises creees apres 2021 | |
| groupe_pont_siren | No | SIREN de la tete de groupe INFEREE (soupcon de groupe via dirigeant-pont). Retourne toutes les societes rattachees au meme groupe soupconne (non declare). A distinguer de siren_groupe (lien capitalistique declare). | |
| est_tete_de_groupe | No | true = uniquement les tetes de groupe | |
| independant_strict | No | true = uniquement les societes reellement independantes : exclut les filiales declarees ET les societes avec un soupcon de groupe fort (groupe_pont probable). Les soupcons plus faibles (possible/soupcon) ne sont pas exclus. | |
| dirigeant_naissance | No | Naissance du dirigeant pour desambiguiser les homonymes, granularite mois : format YYYY-MM. Ex: "1975-03" (un YYYY-MM-DD est accepte mais le jour est ignore). Pour une desambiguisation au jour pres, utiliser search_director_companies. | |
| procedure_collective | No | Procedure collective EN COURS (etat courant, pas l'historique). Valeurs: "liquidation", "redressement", "sauvegarde", "conciliation", "autre", "accord_homologue", "plan_redressement", "plan_sauvegarde", "plan_cession". Plusieurs separes par virgule. "accord_homologue" = accord de conciliation homologue en cours d'execution, ce qui CLOT la conciliation et ne l'ouvre pas ; "conciliation" ne designe qu'une ouverture, que le BODACC ne publie pas. Une procedure cloturee ne matche pas : les societes dont la liquidation est close en sont exclues. | |
| societe_mere_etrangere | No | true = filiales de groupes etrangers uniquement |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| _user_plan | No | ||
| pagination | No | ||
| upgrade_hint | No | ||
| _credits_remaining | No | ||
| include_fields_hint | No | ||
| _quota_remaining_month | No | ||
| _quota_remaining_today | No | ||
| include_fields_skipped | No | ||
| include_fields_unknown | No |