Recherche d'entreprises francaises par nom, SIREN, activite, et criteres financiers.
include_fields : les valeurs d'un filtre financier ou donnees publiques n'apparaissent dans les resultats que si include_fields contient le champ correspondant. Mappings : 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, nb_cessions_min→nb_cessions,derniere_cession_date, a_fusionne→a_fusionne, est_societe_mission→est_societe_mission. Sans include_fields, les valeurs filtrees ne sont pas retournees.
Utiliser cet outil quand l'utilisateur cherche une entreprise par son nom ou veut explorer un secteur.
Recherche de dirigeant : utiliser dirigeant_nom + dirigeant_prenom pour filtrer les entreprises ayant un dirigeant de ce nom. Ajouter dirigeant_naissance (YYYY-MM, granularite mois ; un YYYY-MM-DD est accepte mais le jour est ignore) pour desambiguiser les homonymes. PERIMETRE : ce filtre matche aussi les dirigeants "remontes" depuis une personne morale representee (resolved_from_pm), donc plus large que les seuls mandats directs. Pour l'empreinte corporate DIRECTE d'UNE personne (mandats directs only, desambiguisation au jour pres, sortie centree personne avec le role par societe), preferer search_director_companies. Filtrer par tranche d'age via age_dirigeant_max et advanced_filters (age_dirigeant_min). Accepte aussi les SIRET a 14 chiffres dans le champ query.
Si l'utilisateur demande des informations sur une entreprise par son nom (ex: "donne moi le CA de Vinci"), utiliser d'abord cet outil pour trouver le SIREN, puis utiliser get_company ou get_financials avec le SIREN obtenu. Les resultats sont classes par pertinence ; effectif et statut aident a departager des homonymes.
Une recherche peut etre enregistree avec les memes filtres via create_saved_search (suivi dans le temps, alerte optionnelle sur les nouvelles societes entrant dans les criteres).
FILTRES : les criteres simples (geographie, secteur, effectif, statut, cotation, site web, procedure collective, dates, dirigeants, groupe, financier de base) sont des parametres de premier niveau. Les DEUX bornes d'un de ces criteres s'ecrivent au premier niveau, cote a cote : effectif_min avec effectif_max, et de meme pour ca, resultat_net, tresorerie, cagr_ca, date_creation, age_dirigeant. Ces sept bornes restent aussi acceptees dans advanced_filters, qui l'emporte si elles arrivent aux deux endroits. Tous les criteres avances - ratios, CAGR multi-annees, postes de bilan, delais de paiement, signaux publics (marches, subventions, brevets, cessions, fusions, ESS, societes a mission, fonds PE/VC), commissaires aux comptes, comptes confidentiels/consolides - vivent dans l'objet advanced_filters, dont le schema liste et type chaque cle. Une cle inconnue dans advanced_filters est rejetee (400), pas ignoree.
Organigramme d'un groupe : le filtre siren_groupe (valeur fournie par get_company) liste toutes les societes du groupe.
TRI : sort_by parmi relevance (defaut), chiffre_affaires, resultat_net, effectif_moyen, date_creation, capital. sort_order parmi asc, desc (defaut desc). Exemples : "les 10 plus gros CA" → sort_by=chiffre_affaires, "top 10 par capital social" → sort_by=capital, "les plus anciennes" → sort_by=date_creation sort_order=asc.
Non disponible : le filtrage par profil LinkedIn des dirigeants.
Par defaut retourne 20 resultats (max 20 free / 100 pro par page). La pagination est reservee au plan Pro.
COUT EN APPELS : une page est facturee 1 appel de quota par tranche de 20 lignes servies. limit=20 coute 1 appel, limit=100 en coute 5. Demander 100 lignes ne consomme donc pas plus qu'enchainer cinq pages de 20, mais ne consomme pas moins non plus : l'interet est d'eviter le plafond par minute, pas d'economiser du quota.
La reponse inclut "_user_plan" ("free" ou "pro"). include_fields est limite a 3 champs par recherche sur free et 10 sur pro ; les champs au-dela de la limite sont ignores et listes dans include_fields_skipped. Un nom de champ inconnu n'est pas une erreur : il est ignore et liste dans include_fields_unknown - lire ce champ et corriger le nom, plutot que de retomber sur un get_company par ligne.
COUT ET CONTENU (le compte a un quota d'appels borne, et la reponse dit ou il en est) :
- "_quota_remaining_today" et "_quota_remaining_month" donnent le nombre d'appels encore disponibles sur le compte.
- Une recherche renvoie jusqu'a 20 societes par appel de quota. Une fiche get_company coute 1 appel par societe.
- Le siren de chaque societe est deja dans le resultat : resolve_companies sert a rapprocher des fiches sans identifiant (nom, adresse), pas des resultats de recherche.
- ca, ebitda, resultat_exploitation, resultat_net, effectif_moyen et annee_financiere du dernier exercice sont disponibles ici en include_fields ; get_financials sert l'historique multi-annees et les postes detailles.
- nb_cessions et derniere_cession_date (include_fields) indiquent si une societe a des evenements de cession a lire dans get_events.
Retourne : siren, denomination, code_ape, code_ape_lib, ville, departement, region, effectif, statut, date_creation, forme_juridique, est_filiale, groupe_parent + les champs demandes via include_fields. Si besoin d'historique multi-annees, enchainer avec get_financials.