insourcia

 ⟨33 unchanged words⟩ depot_comptes,
augmentation_capital, marche_public, subvention, radiation, creation.
Ce n'est PAS le fil de veille : pour les signaux recents des societes suivies (nouveau bilan, score credit, dissolution...), utiliser get_news.

Couvre les evenements BODACC (cessions, procedures collectives ⟨171 unchanged words⟩ 

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"depth":{"description":"Profondeur  ⟨75 unchanged words⟩ juridique 65xx)","type":"boolean"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"max_nodes":{"description":"Nombre max de noeuds ⟨71 unchanged words⟩ ,"minItems":1,"type":"array"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"factors_limit":{"description":"Nombre  ⟨9 unchanged words⟩ "minimum":1,"type":"integer"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"siren":{"description":"SIREN a 9 chiffres ⟨45 unchanged words⟩ ,"minItems":1,"type":"array"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"include_inactive":{"description":"Inclure  ⟨28 unchanged words⟩  par societe.","type":"number"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"offset":{"description":"Pagination (defaut 0) ⟨62 unchanged words⟩ ,"minItems":1,"type":"array"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"date_max":{"description":"Date  ⟨29 unchanged words⟩  par societe.","type":"number"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"offset":{"description":"Pagination (defaut 0) ⟨72 unchanged words⟩ d'evenement (CSV)","type":"string"}},"required":["llm_model"],"type":"object"}

 ⟨185 unchanged words⟩ un bloc ifrs.

Compte de resultat confidentiel : estimation_financiereaucun donneCA ni EBE depose. Par defaut la reponse porte estimation_disponible (exercice + message) sans aucun chiffre estime ; inclure_estimation=true ajoute estimation_financiere (fourchette de CA, confiance, tranche de marge d'EBE et, probabilite de deficit. C'estdeficit), une ESTIMATION : la presenter comme telle,et jamais comme un chiffre depose. dividende_estime est aussi une estimation (dividendes_verses = depose).

Rendu : _layout  ⟨39 unchanged words⟩ 

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"detail":{"description":"compact  ⟨61 unchanged words⟩ :"string"},"type":"array"},"inclure_estimation":{"description":"Comptes au compte de resultat confidentiel : true ajoute estimation_financiere (CA et marge d'EBE ESTIMES, pas deposes). false (defaut) : seul estimation_disponible signale qu'une estimation existe.","type":"boolean"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"siren":{"description":"SIREN a 9 chiffres ⟨87 unchanged words⟩  max 10)","type":"number"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"event_types":{"description":"Filtre  ⟨35 unchanged words⟩ "minimum":-9007199254740991,"type":"integer"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"since_days":{"description":"Profondeur d'historique en jours ⟨21 unchanged words⟩ Defaut : false.","type":"boolean"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"limit":{"description":"Nombre  ⟨7 unchanged words⟩ 9007199254740991,"minimum":-9007199254740991,"type":"integer"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"list_name":{"description":"Nom  ⟨15 unchanged words⟩  toutes les listes.","type":"string"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalPropertiesproperties":false,{"propertiesllm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"read_keys":{"description":"Cles \"read_key\"  ⟨32 unchanged words⟩ type":"array"}},"required":["read_keys","llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalPropertiesproperties":false,{"propertiesllm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"records":{"description":"Fiches a rapprocher,  ⟨162 unchanged words⟩ type":"string"}},"required":["records","llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"date_naissance":{"description":"Date  ⟨21 unchanged words⟩  200).","type":"number"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"nom":{"description":"Nom de famille du ⟨14 unchanged words⟩ ,"required":["nom","prenom","date_naissance","llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"include_inactive":{"description":"Inclure  ⟨17 unchanged words⟩  50).","type":"number"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"nom":{"description":"Nom de famille du ⟨24 unchanged words⟩ type":"string"}},"required":["nom","llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"cedant_siren":{"description":"SIREN  ⟨94 unchanged words⟩ max 200)","type":"number"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"prix_max":{"description":"Prix de vente max ⟨88 unchanged words⟩ etroit que departement.","type":"string"}},"required":["llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"list_name":{"description":"Nom  ⟨24 unchanged words⟩ "minLength":1,"type":"string"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"siren":{"description":"SIREN a 9 chiffres ⟨12 unchanged words⟩ type":"string"}},"required":["siren","llm_model"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"enable_alert":{"description":"true  ⟨43 unchanged words⟩ "minLength":1,"type":"string"},"llm_model":{"description":"The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess.","type":"string"},"siren":{"description":"SIREN a 9 chiffres ⟨9 unchanged words⟩ type":"string"}},"required":["siren","llm_model"],"type":"object"}

 ⟨882 unchanged words⟩ de salaries)","type":"number"},"estimation_confiance_min":{"description":"Avec inclure_estimations : confiance minimale des estimations retenues.","enum":["haute","moyenne","faible"],"type":"string"},"filter_annee":{"description":"Annee de l'exercice financier. ⟨221 unchanged words⟩  donnees publiques et texte.","type":"string"},"inclure_estimations":{"description":"Filtres de CA : false (defaut) = CA publie seul ; la reponse donne alors estimations_complement (societes au compte de resultat confidentiel dont le CA ESTIME passerait) : le signaler et proposer de les inclure. true = les inclure, chacune avec estimation_ca (fourchette, confiance) ; les presenter comme estimees, jamais comme un CA depose.","type":"boolean"},"is_cotee":{"description":"true pour ⟨465 unchanged words⟩ 

 ⟨128 unchanged words⟩ pro).
4. Gouvernance - dirigeants principaux.
5. Groupe - est_filiale, parents direct et ultime, societe_mere, tete de groupe (siren_groupe, a passer a search_companies pour lister le groupe), nb filiales. Absent = independante.
6. IFRS - agregats consolides des cotees.
7.6. Signaux - cotation, procedures collectives, fusions,  ⟨10 unchanged words⟩ , societe a mission, dernier depot, radiation.
8.7. Score credit - grade AAA a D,  ⟨6 unchanged words⟩ ; detail dans get_credit_risk. Null si non scoree.
9.8. Cessions - historique (date, type, cedant, cessionnaire, prix).
10.9. Donnees publiques - marches publics, subventions, brevets, salons.
11.10. Fonds PE/VC - nom_fonds, siren_fonds (chainable vers ⟨21 unchanged words⟩ 

 ⟨8 unchanged words⟩ criteres (geographie, secteur, effectif, financier, dirigeants, groupe). Pour une societe citee par son nom ⟨119 unchanged words⟩ ; 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 (+  ⟨97 unchanged words⟩ 

 ⟨111 unchanged words⟩ denomination, role, ville, departement, code_ape, forme_juridique, est_tete_de_groupe } + pagination { total, returned, limit  ⟨65 unchanged words⟩  structure de detention capitalistique d'une entreprise, voir les champs groupe de get_company.get_company_graph.

 ⟨13 unchanged words⟩ parametre sirens sert jusqu'a 10 fiches en une seule requete, au lieu d'un appel par societe.

 COUT : 1 appel de quota par societe, queen leslot societescomme soienta demandeesl'unite. unePour parcomparer unebeaucoup oude ensocietes, lot.search_companies Lesrend les memes champs, descriptifen d'activiteinclude_fields (dont description_activite) et site web (site_internet) compris, sont disponibles en include_fields sur search_companies, qui rend jusqu'a 20 societes par appel de quota. "_quota_remaining_today" indique le quota restant du compte.

Une societe peut etre mise sous surveillance via watch_company (alerte optionnelle sur les evenements futurs : procedures collectives, cessions, changements de dirigeants).appel.

Contenu de la fiche :
1. Identite —- forme juridique, date creation, date_immatriculation (RCS), date_cloture_exercice (JJ-MM, datedates de cloturecreation comptableet recurrente)d'immatriculation, denomination_usuelle si presentedate_cloture_exercice, capital social, siege (adresse complete rue+numero, code postal, departement, region)complet, activite (code NAF + libelle +, objet_social si disponible +, description si disponible), effectif. Le codeeffectif, LEI (Legal Entity Identifier) est expose au top-level pour les societes ayant un identifiant ESEF/GLEIF (typiquement les cotees). Sisi radieepresent :; successeur (siren,si denomination).radiee.
2. Financier —- date_cloture (annee) et type_bilan (K=consolideK consolide, C=complet/socialC social, S=simplifie)S simplifie : un CA en bilan K (consolide groupe) n'est pas comparable a un bilanCA C (social)., CA, croissance CA, resultat net, marge nette, EBITDAmarges, marge EBITDA, dette nette, effectif moyen.
3. Contact —- site web, telephone, email (pro),et LinkedIn (pro).
4. Gouvernance —- dirigeants principaux (president, DG), structure PM le cas echeant.principaux.
5. Groupe - appartenance a un groupe (est_filiale, nom du groupe), parentparents direct et ultime (denomination, SIREN, pays), societe_mere (holding mere directe : siren, denomination, pays, leitete -de sourcegroupe distincte(siren_groupe, souvent renseigneea quandpasser parent_direct/ultimea sontsearch_companies absents),pour tetelister dele groupe (est_tete_de_groupe, siren_groupe), nb filiales directes.filiales. Absent = independante.
6. IFRS — si disponible (societes cotees), donnees financieres consolidees IFRS : CA, resultat net, EBITDA, total actif. Absent pour- lesagregats societesconsolides nondes cotees.
7. Signaux —- cotation, procedures collectives (historique avec type, date, tribunal, jugement), a_fusionnefusions, modifications de capital, transferts de siege, changements de denomination, est_societe_missionESS, est_ess,societe reconstitution_capitaux_propres,a dernier_depot_datemission, comptesdernier confidentielsdepot, date radiation.
8. Score credit (credit_risk, tous plans) —- grade AAA ->a D, probabiliteprobabilites de defaut a 3/6/12 mois (taux du grade), 5 facteurs aggravants/attenuants,; datedetail dudans score.get_credit_risk. Null si la societe n'a pas de bilan recent (non scoree). Detail et explication : get_credit_risk.scoree.
8.9. Cessions — total, derniere_date,- historique[] (date, type, cedant, cessionnaire, activite, prix). Null si aucune.
9.10. Donnees publiques — marches_publics (nb,- montant,marches types)publics, subventions (nb, montant, regions), brevets (nb total, nb actifs), salons (nb participations, secteurs). Null si aucune donnee.salons.
10.11. Fonds d'investissement — bloc fonds si l'entreprise est detenue par un fonds (PE/VC) :- nom_fonds, siren_fonds (SIREN du fonds, permet de chainerchainable vers get_company), type_fonds, annee_entree_fonds, nb_fonds_actuels. Nullannee sinon.d'entree.

Pour approfondir : get_financials (historique multi-annees), get_directors (detail dirigeantsmandats), get_events (timelineannonces BODACC/evenementsBODACC), deget_company_graph l'entreprise(structure). watch_company met la societe sous surveillance.

 ⟨16 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨51 unchanged words⟩ 

Cartographie des entites autour d'UNE entreprise (par SIREN) : graphe ORIENTE et TYPEoriente construit sur les mandats RCS/RNE et les liens de groupe.

Utiliser cet outil pour visualiser ou analyserPour la structure d'un groupe : holdings, filiales, societes soeurs, dirigeants communs. Complementaire de get_directors (detail des mandats d'UNEd'une societe) et de search_director_companies (empreinte d'UNEd'une personne).

Reponse : nodes[] (entreprises et"co:<siren>", personnes physiques"pp:<nom>|<prenom>|<AAAA-MM>", parents etrangers "co:ext:<slug>") +et edges[] (aretes orientees source -> cible) :
- mandat_pm : societe dirigeante -> societe dirigee (role, est_actif ; dates de mandat en best-effort, souvent absentes)
- filiale : societe mere -> filiale (lien associe unique RNE, detention 100% implicite)
- parent_ultime : parent ultime (GLEIF, grands groupes) -> societe
- mandat_pp : personne physique -> societe dirigee (role)

Points cles :
- Les commissaires aux comptes sont EXCLUS des aretes (un CAC n'est pas de la gouvernance).
- Ids : entreprises "co:<siren>" ; personnes "pp:<nom>|<prenom>|<AAAA-MM>" (date de naissance en precision mois) ; parents etrangers horsA indexsavoir "co:ext:<slug>".
- Pas de pourcentagespourcentage de detention (nondetention. disponiblesLes danscommissaires lesaux sourcescomptes publiquessont utilisees).exclus.
- depth=1 : liens directs de la racine.directs. depth=2 (defaut) : expansion depuis les noeuds structurants (parents, et societes dirigeantes) -, jamais depuis les filiales pour eviter l'explosion sur les grands groupes.filiales.
- Expansion via les personnes (defaut ON, depth=2) : lesLes dirigeants de la RACINEracine tirent leurs AUTRESautres societes dans le graphe (holdings personnelles, SCI, structures soeurs d'un meme gerant = groupes de fait sans holding). Expansion depuis la racine uniquement, jamais depuis les niveaux suivants. Desactivable avec expand_persons=false pourdonne un graphe purement capitalistique.
- Garde hub-dirigeant : un dirigeant de la racine qui est unUn mandataire professionnel (expert-comptable / officier en serie) n'est PAS etendu - son portefeuille est un carnet de clients, pas le groupe. Detecte par un footprint eleve (plus de 50 societes dirigees) OU un mandat dansmandats, unou cabinet comptable/audit. Le dirigeant reste dans le graphe (il est officier declare de la racinecomptable) mais ses autres societes ne sontn'est pas tirees. Ces dirigeants sontetendu listes: dansvoir meta.truncated.hub_directors.
- CapsPlafonds par noeud (20 filiales, 20 societes dirigees, 40 societes par personne) et global (max_nodes) : les troncatures sont signalees dans meta.truncated (dont hub_directors pour les mandataires non etendus) -signale leun graphe peut etre partiel.

Filtres : include_personnes (defaut true), include_sci (false = exclure les SCI), include_ceased (false = exclure les societes cessees), expand_persons (defaut true).expand_persons. La racine n'est jamais filtree.

Pour plusieurs entreprises, le parametre sirens sert 3 graphes en une requete, (2 en depth=2.depth=2), Cea plafonddepth=1 estpar basdefaut parce: qu'uneune traversee a froid coute 3 a 5 secondes et ne se parallelise pas sur le serving. Autre difference avec l'appel unitaire : le lot part a depth=1, la ou une societe seule part a depth=2.pas.

 ⟨95 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨42 unchanged words⟩ 

 ⟨91 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨39 unchanged words⟩ 

 ⟨27 unchanged words⟩ , role, annee de naissance, date_debut_mandat, date_fin_mandat, linkedin_url
- **PM** (personne morale) : denomination,  ⟨38 unchanged words⟩  Utile pour identifier le mandataire actif vs sortant.

linkedin_url est le profil LinkedIn de la personne physique, present uniquement quand un profil a ete apparie avec certitude (nom + prenom + date de naissance). La clef est absente quand aucun profil n'est confirme : c'est le cas courant, pas une anomalie. Reserve au plan pro.

Par defaut, seuls les mandataires actifs sont  ⟨59 unchanged words⟩ 

 ⟨38 unchanged words⟩ "},{"type":"null"}]},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"nom":{"anyOf":[{"type":"string ⟨71 unchanged words⟩ "},{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today ⟨65 unchanged words⟩ 

Timeline unifiee des evenements d'UNE entreprise (par SIREN).

FusionneFlux cessions[]chronologique +decroissant procedures[]qui +reunit dates:
- scalairesune ligne par annonce BODACC de modification (depot_comptesforme juridique, augmentation_capitaldirigeants,
marche_public siege, subventionactivite, radiationcapital, creationdenomination, dissolution), enavec libelle, sous_type et source_url vers l'avis officiel ;
- une ligne par depot des comptes (un fluxpar chronologiqueexercice) decroissant.et par immatriculation ;
- les cessions (y compris cote cedant d'une vente) et les procedures collectives ;
- la radiation, l'augmentation de capital, la creation ;
- une ligne par annee de marches publics, les subventions ;
- sur 12 mois, les mouvements de dirigeants et changements de groupe ou de note credit (types dirigeant_*, changement_*).

Pour plusieurs entreprises, le parametre sirens sert  ⟨24 unchanged words⟩ 

COUT : 1 appel de quota par societe. La timeline est vide pour la majorite des societes ; search_companies indique lesquelles portent des evenements de cession via include_fields=nb_cessions,derniere_cession_date.

 ⟨49 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨65 unchanged words⟩ 

 ⟨9 unchanged words⟩  : 1 appel de quota par societe, pour une reponse de ~10 a 45 Kio selon detail et years. Perimetre : l'historique multi-annees et les postes detailles. Les agregatsPour dule seul dernier exercice (ca, ebitda, resultat_exploitation, resultat_net, effectif_moyen), annee_financiere)search_companies sontle disponiblesrend en include_fields sur search_companies, qui rend jusqu'a 20 societes par appel.

Pour plusieurs entreprises, le ⟨4 unchanged words⟩ 10 historiques en une requete (3 en detail=full, une reponse pesant alors ~330 Kio pour dix). Deux differences avec des appels un par un : leLe lot part en mode compact sauf demande explicite, y compris sur plan Pro, et il ne pagine pas.

DefautNiveau plan-awarede detail :
- Plan freecompact :(defaut modesur `compact`free, (~40 champs /par exercice). Compte: compte de resultat complet (CA -> resultat net en passant par EBITDA, REX, financier, exceptionnel, IS), bilan abrege PCG (actif immobilise net, stocks, creances clients, disponibilites, total general actif, total actif ; capital social, reserves, report a nouveau, capitaux propres, provisions, dettes financieres, dettes fournisseurs, dettes fiscales/sociales, total dettes, total passif), ratios (tresorerie, dette nette, BFR, marges, ratio endettement, CAF, delais de paiement), dividendes verses, effectif moyen.
- Plan pro : mode `full` par defautfull (~140 champsdefaut /sur exercicePro, audit financier exhaustif). Override explicite via `detail=compact` si on veut la vue resumee.

Mode `detail=full` (audit financier~140 exhaustifchamps) : retourne TOUStous les champs financierspostes. disponiblesRefuse (~140sur parfree exercice(403). Sur plan gratuit, renvoie 403 upgrade_required ; sur plan Pro c'est le
- defaut.

Modefields `fields`: (recommandeajoute pourquelques 1-5champs ratiosa additionnelscompact au-dessussans degonfler compact)la :reponse, passerex fields=["roe","bfr_jours_ca","autonomie_financiere"] ajoute les champs cibles a chaque exercice sans gonfler la reponse.. Plus de 130 champs disponibles : ratios (roe, taux_marge_brute, liquidite_generale, capacite_remboursement, etc.), postes detailles (achats_marchandises, salaires_traitements, etc.), immobilisations brutes (terrains_brut, constructions_brut, etc.), reserves (reserve_legale, primes_emission_fusion_apport, etc.), croissancecroissances (cagr_ebitda_3ans, cagr_rn_signed_5ans, etc.cagr_ebitda_3ans...).

Bloc `ifrs`type_bilan : pour les societesK coteesconsolide, retourneC ensocial, plusS unsimplifie. objetQuand ifrsla avecfenetre lesmelange agregatsplusieurs comptestypes, consolidesun (chiffre_affaires,seul ebitda,est bpa,garde dividendes,et etc.).

Rendutype_bilan_mixte :l'indique la; reponsetype_bilan inclutforce `_layout`,un quitype. decritLes parcotees sectionont (compteen deplus resultat,un bilanbloc actif,ifrs.

Rendu bilan: passif,_layout ratios,decrit dividendes,par effectif)section l'ordre PCG des lignes, leur libelle francais (`line.label`line.label), leur niveau d'indentationindentation (`level`, 2 = lignes "dont ..."level) et leur nature (`kind` : value, subtotal, totalkind). `exercices; exercices[annee][line.key]` porte la valeur ;, null = poste absent de la source. `_layout.not_applicable_pcg:absent. true`not_applicable_pcg signale un plan comptable sectoriel (bilan Bde banque, A assurance) ; `_layout.missing_pcg_lines` liste les lignes PCG absentes de notreou source.d'assurance. Montants en euros ; `_layout.doc_url` pointe la documentation du format.euros.

 ⟨517 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨48 unchanged words⟩ 

 ⟨233 unchanged words⟩ les signaux non retournes parce que le plan Freeactuel ne donne acces qu'aux 10 signaux les plus recents, exactement comme la page /news. Ne presente jamais unUn fil ainsi tronque comme complet : dis combien de signauxn'est sontpas masquescomplet, et que le planhidden_by_plan Prodit lesde ouvre.combien.

Reponse : { news: [...], total ⟨21 unchanged words⟩ 

Rapprochement EN LOT de fiches mal identifiees vers leur SIREN - la forme qu'un (CRM, un tableur ou un, export CSV contient.

Utiliser cet) outilvers quandleur l'utilisateurSIREN.

A arriveutiliser avecpour une LISTE de societes a identifier ("voici 200 clients, retrouve leursles SIREN", "rapproche ce fichier",de "nettoieces ma200 baseclients"). Pour UNE societe cherchee par son nom, utiliser search_companies :, ilqui rend des resultats classes, ; celui-ci rend une decision.

Difference de nature avec search_companies : cetdecision, outilet REFUSErefuse de trancher quand il n'est pas sur, et le dit. Il ne rend jamais un "meilleur resultat" par defaut.sur.

Chaque fiche revient avec un status :
- resolved : SIREN certain, exploitable directement.certain.
- review    : plusieurs candidats plausibles OUou nom trop generique ; les candidats sont retournes et le choix revient a l'utilisateur.
- no_match : aucune correspondance.

Le champ reason explique un review : ambiguous_candidates, weak_name_overlap, shared_domain (deuxsite societespartage equivalentes,par ilun fautreseau departager),; weak_name_overlapdomain_company_count (ledit nomcombien nede recouvresocietes, pasfournir assezun lenom candidatou un code postal), missing_name, invalid_domain, domain_no_match, lookup_failed (panne technique, a rejouer - ce n'est, PAS une absence de correspondance).

Conseils : domain (domaine ou URL) resout seul quand il designe une seule societe. Le code postal double quasiment le taux de rapprochement automatique.rapprochement. Un jetonmot en trop dans le nom ("Carrefour Massy" au lieu de "Carrefour") degradenuit plus le rapprochement qu'un nom tronque.

Instantane et sans risque d'erreur quand la fiche porte deja un identifiant : unUn siren, un siret (les 9 premiers chiffres) ou un numero de TVA francais sontest resolusresolu sans aucune recherche. Le quota, lui, compte les fiches soumises

COUT : un1 lotappel de 200quota coutepar 200fiche appelssoumise, quelle que soit leursa forme.

Retourne results[] (dans l'ordreordre d'entree, avec l'id fourni s'il y en a un) et summary{total, resolved, review, no_match}. summary indique si le fichier est exploitable tel quel ou s'il demande un passage manuel.

 ⟨15 unchanged words⟩ items":{"additionalProperties":false,"properties":{"domain":{"description":"Site web de la societe, en domaine nu ou en URL complete. Tranche mieux qu'un nom quand il est connu.","maxLength":253,"type":"string"},"id":{"description":"Identifiant libre renvoye tel ⟨82 unchanged words⟩ ":200,"minItems":1,"type":"array"},"shared_domain":{"description":"Domaine porte par plusieurs societes : review (defaut) rend les candidats ; head rapproche vers la maison mere (groupe dominant, sinon plus gros CA), method=domain_head, confiance basse. Reserver aux colonnes d'enseignes.","enum":["review","head"],"type":"string"}},"required":["records"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨123 unchanged words⟩ 

Recherche d'entreprises francaises par nom, SIRENSIREN/SIRET, 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,criteres nb_subventions_min→nb_subventions,montant_subventions_total(geographie, nb_brevets_min→nb_brevets,nb_brevets_actifssecteur, nb_cessions_min→nb_cessions,derniere_cession_dateeffectif, a_fusionne→a_fusionnefinancier, est_societe_mission→est_societe_mission. Sans include_fieldsdirigeants, les valeurs filtrees ne sont pas retournees.

Utiliser cet outil quand l'utilisateurgroupe). cherchePour une entreprisesociete citee 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.trouver Ajouterle dirigeant_naissanceSIREN (YYYY-MMici, granularite mois ; un YYYY-MM-DD est acceptepuis maisget_company leou jourget_financials. estEffectif ignore)et pourstatut desambiguiserdepartagent les homonymes. PERIMETRE

- :Le cesiren filtreest matchedans aussichaque lesresultat dirigeants: "remontes"ne depuispas uneles personnerepasser moralepar representeeresolve_companies (resolved_from_pm), donc plus large que les seuls mandats directs.fiches Poursans l'empreinteidentifiant).
- corporateValeurs DIRECTE: d'UNEun personnechiffre (mandats directs onlyca, desambiguisation au jour presebitda, sortie centree personne avec le role par societe)resultat_net, preferer search_director_companies. Filtrer par tranche d'age via age_dirigeant_max eteffectif_moyen, advanced_filterssignaux (age_dirigeant_minpublics...). Accepte aussi lesn'est SIRETretourne aque 14s'il chiffresfigure 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 SIRENinclude_fields, puis utiliser get_company ou get_financials avecmeme lequand SIRENil obtenu.sert Lesde resultatsfiltre. sont3 classeschamps 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 tempsfree), alerte10 optionnelle(pro). surUn lesnom nouvellesinconnu societesest entrantliste dans les criteres).

FILTRESinclude_fields_unknown : les criteres simples (geographie, secteur, effectif, statut,le cotation,corriger siteplutot web,que procedured'appeler collective,get_company dates,ligne dirigeants,par groupe,ligne. financierget_financials desert base)l'historique sontmulti-annees.
- desFiltres parametressimples deau premier niveau.niveau, Lesles DEUXdeux bornes d'un de ces criteres s'ecrivent au premier niveau, cote a cote : (effectif_min avec effectif_max, et deeffectif_max meme; pouridem 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 lesage_dirigeant). criteresCriteres 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 comptesCAC, comptes confidentiels/consolides - vivent) dans l'objet advanced_filters, dont le schema liste et type chaque cle.; Uneune cle inconnue dans advanced_filters est rejetee (400), pas ignoree.

Organigramme d'un.
- groupeGroupe : le filtre siren_groupe (valeur fourniedonnee par get_company) liste toutes les societes du groupe.

TRI
- Dirigeant : sort_bydirigeant_nom parmi+ relevancedirigeant_prenom (defaut+ dirigeant_naissance),. chiffre_affaires,Inclut resultat_net,les effectif_moyen,dirigeants date_creation,remontes capital.via sort_orderune parmipersonne asc,morale desc; (defautmandats desc).directs Exemplesd'une :personne "les: 10search_director_companies.
- plusTri gros: CA"sort_by →(relevance, sort_by=chiffre_affaireschiffre_affaires, "topresultat_net, 10effectif_moyen, pardate_creation, capital) social"et →sort_order.
- sort_by=capital,Cessions "les: plusinclude_fields=nb_cessions,derniere_cession_date anciennes"signale →les sort_by=date_creationsocietes sort_order=asc.

Nona disponiblelire :dans leget_events.

20 filtrageresultats par profil LinkedIn des dirigeants.

Par defaut retourne 20 resultats, (max 20 (free) /ou 100 (pro par page). La; pagination est reserveepar aucursor plansur Pro.

COUT EN APPELSCOUT : 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 proservies ; 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 - lirereponse cedonne champ_user_plan et corriger le nom, plutot que de retomber sur un get_company par ligne.

COUT ET CONTENU (le compte a un quota d'appelsrestant. borne,Pour etsuivre 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 resultattemps : resolve_companies sert a rapprocher des fiches sans identifiant (nom, adresse), pas descreate_saved_search.

Retourne resultatsl'identite 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 evenementsbase de cession a lire dans get_events.

Retournechaque :societe (siren, denomination, code_ape, code_ape_lib, ville, departementNAF, regionlocalisation, 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.

 ⟨1063 unchanged words⟩ },"include_fields":{"description":"Champs a inclureajouter dansa chaque resultat (CSV). pourUne quevaleur lesfiltree valeursn'apparait d'unque filtresi financierson ouchamp donneesest publiquesdemande. apparaissent.Montants Mapping

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨168 unchanged words⟩ 

 ⟨91 unchanged words⟩  role_description, date_naissance, annee_naissance, lieu_naissance, type_personne, linkedin_url, entreprise { siren, denomination, ville, departement, code_ape } }. linkedin_url n'est present que si un profil a ete apparie avec certitude (plan pro) ; son absence est le cas courant, pas une anomalie. pagination { total (nb entreprises matchees), limit ⟨4 unchanged words⟩ meme nom+prenom recouvre souvent plusieurs personnes distinctes. date_naissance (et lieu_naissance) est le champ qui les distingue : deux  ⟨10 unchanged words⟩  non confirmee ; meme date = meme personne. La date est diffusee au MOIS (jour normalise a 01), conformement au regime de diffusion du registre : deux personnes nees le meme mois restent indistinguables.

Pour lister TOUTES les entreprises d'une personne donnee ⟨30 unchanged words⟩ 

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨31 unchanged words⟩ 

 ⟨67 unchanged words⟩ au moins un filtre region / departement / ville / code_naf, OU un filtre d'evenement
(date_min, date_max, cedant_siren, cessionnaire_siren, prix_min/max, tribunal, procedure_type) — sinon 400.

IMPORTANT : passer UN SEUL type quand la question porte sur un type precis. Les filtres de cadrage
(existence de l'evenement, fenetre de dates) ne sont pousses dans la requete que dans ce cas ; avec
plusieurs types ils s'excluraient mutuellement, et la recherche se rabat sur un tri general dont on
ne lit que les premieres pages — une question pointue y parait vide.

Cas d'usage :
- "Cessions de fonds > ⟨15 unchanged words⟩  collectives a Lyon" → type="procedure", departement=ville="69Lyon"
- "Liquidations prononcees a Marseille en juillet 2026" → type="procedure", procedure_type="liquidation", ville="Marseille", date_min="2026-07-01", date_max="2026-07-31"
- "Marches publics recents dans le BTP ⟨5 unchanged words⟩ 

 ⟨146 unchanged words⟩  Defaut : tous.","type":"string"},"ville":{"description":"Ville du siege (CSV possible). Ex: \"Marseille\". Le bon filtre pour un ressort de tribunal : plus etroit que departement.","type":"string"}},"type":"object"}

 ⟨13 unchanged words⟩ parametre sirens sert jusqu'a 10 fiches en une seule requete, au lieu d'un appel par societe. 

COUT : 1 appel de quota par societe, en lotque commeles asocietes l'unite.soient Pourdemandees comparerune beaucouppar deune societes,ou search_companiesen rendlot. lesLes memes champs, endescriptif include_fieldsd'activite (dont description_activite) et site web (site_internet) compris, sont disponibles en include_fields sur search_companies, qui rend jusqu'a 20 societes par appel.appel de quota. "_quota_remaining_today" indique le quota restant du compte.

Une societe peut etre mise sous surveillance via watch_company (alerte optionnelle sur les evenements futurs : procedures collectives, cessions, changements de dirigeants).

Contenu de la fiche :
1. Identite -— forme juridique, dates dedate creation, etdate_immatriculation d'immatriculation(RCS), date_cloture_exercice (JJ-MM, date de cloture comptable recurrente), denomination_usuelle si presente, capital social, siege complet(adresse complete rue+numero, code postal, departement, region), activite (code NAF, + libelle + objet_social, si disponible + description si disponible), effectif,effectif. Le code LEI si(Legal presentEntity ;Identifier) est expose au top-level pour les societes ayant un identifiant ESEF/GLEIF (typiquement les cotees). Si radiee : successeur si(siren, radiee.denomination).
2. Financier -— date_cloture (annee) et type_bilan (K consolideK=consolide, C socialC=complet/social, S simplifieS=simplifie) : un CA en bilan K (consolide groupe) n'est pas comparable a un CAbilan C (social),. CA, croissance CA, resultat net, margesmarge nette, EBITDA, marge EBITDA, dette nette, effectif moyen.
3. Contact -— site web, telephone, email et(pro), LinkedIn (pro).
4. Gouvernance -— dirigeants principaux.principaux (president, DG), structure PM le cas echeant.
5. Groupe - appartenance a un groupe (est_filiale, parentsnom du groupe), parent direct et ultime (denomination, SIREN, pays), societe_mere (holding mere directe : siren, tetedenomination, depays, groupelei (siren_groupe- source distincte, asouvent passerrenseignee aquand search_companiesparent_direct/ultime poursont listerabsents), letete de groupe (est_tete_de_groupe, siren_groupe), nb filiales.filiales directes. Absent = independante.
6. IFRS -— agregatssi consolidesdisponible des(societes cotees), donnees financieres consolidees IFRS : CA, resultat net, EBITDA, total actif. Absent pour les societes non cotees.
7. Signaux -— cotation, procedures collectives (historique avec type, fusionsdate, modificationstribunal, dejugement), a_fusionne, modifications capital, transferts de siege, changements de denomination, ESSest_societe_mission, societeest_ess, areconstitution_capitaux_propres, missiondernier_depot_date, derniercomptes depotconfidentiels, date radiation.
8. Score credit -(credit_risk, tous plans) — grade AAA a-> D, probabilitesprobabilite de defaut a 3/6/12 mois (taux du grade), 5 facteurs ;aggravants/attenuants, detaildate dansdu get_credit_risk.score. Null si la societe n'a pas de bilan recent (non scoree.scoree). Detail et explication : get_credit_risk.
9.8. Cessions -— total, derniere_date, historique[] (date, type, cedant, cessionnaire, activite, prix). Null si aucune.
10.9. Donnees publiques -— marchesmarches_publics publics(nb, montant, types), subventions (nb, montant, regions), brevets (nb total, salons.nb actifs), salons (nb participations, secteurs). Null si aucune donnee.
11.10. Fonds d'investissement — bloc fonds si l'entreprise est detenue par un fonds (PE/VC) -: nom_fonds, siren_fonds (chainableSIREN du fonds, permet de chainer vers get_company), anneetype_fonds, d'entree.annee_entree_fonds, nb_fonds_actuels. Null sinon.

Pour approfondir : get_financials (historique multi-annees), get_directors (mandatsdetail dirigeants), get_events (annoncestimeline BODACC),BODACC/evenements get_company_graphde (structurel'entreprise). watch_company met la societe sous surveillance.

 ⟨16 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨51 unchanged words⟩ 

Cartographie des entites autour d'UNE entreprise (par SIREN) : graphe orienteORIENTE et TYPE construit sur les mandats RCS/RNE et les liens de groupe.

Utiliser Pourcet outil pour visualiser ou analyser la structure d'un groupe : holdings, filiales, societes soeurs, dirigeants communs. Complementaire de get_directors (detail des mandats d'uned'UNE societe) et de search_director_companies (empreinte d'uned'UNE personne).

Reponse : nodes[] (entreprises "co:<siren>",et personnes "pp:<nom>|<prenom>|<AAAA-MM>", parents etrangers "co:ext:<slug>"physiques) et+ edges[] (aretes orientees source -> cible) :
- mandat_pm : societe dirigeante -> societe dirigee (role, est_actif ; dates de mandat en best-effort, souvent absentes)
- filiale : societe mere -> filiale (lien associe unique RNE, detention 100% implicite)
- parent_ultime : parent ultime (GLEIF, grands groupes) -> societe
- mandat_pp : personne physique -> societe dirigee (role)

APoints savoircles :
- Les commissaires aux comptes sont EXCLUS des aretes (un CAC n'est pas de la gouvernance).
- Ids : entreprises "co:<siren>" ; personnes "pp:<nom>|<prenom>|<AAAA-MM>" (date de naissance en precision mois) ; parents etrangers hors index "co:ext:<slug>".
- Pas de pourcentagepourcentages de detention.detention Les(non commissairesdisponibles auxdans comptesles sontsources exclus.publiques utilisees).
- depth=1 : liens directs.directs de la racine. depth=2 (defaut) : expansion depuis les parentsnoeuds etstructurants (parents, societes dirigeantes,) - jamais depuis les filiales.filiales pour eviter l'explosion sur les grands groupes.
- LesExpansion via les personnes (defaut ON, depth=2) : les dirigeants de la racineRACINE tirent leurs autresAUTRES societes dans le graphe (holdings personnelles, SCI, structures soeurs d'un meme gerant = groupes de fait sans holding). Expansion depuis la racine uniquement, jamais depuis les niveaux suivants. Desactivable avec expand_persons=false donnepour un graphe purement capitalistique.
- UnGarde hub-dirigeant : un dirigeant de la racine qui est un mandataire professionnel (expert-comptable / officier en serie) n'est PAS etendu - son portefeuille est un carnet de clients, pas le groupe. Detecte par un footprint eleve (plus de 50 mandats,societes oudirigees) OU un mandat dans un cabinet comptablecomptable/audit. Le dirigeant reste dans le graphe (il est officier declare de la racine) n'estmais ses autres societes ne sont pas etendutirees. :Ces voirdirigeants sont listes dans meta.truncated.hub_directors.
- PlafondsCaps par noeud (20 filiales, 20 societes dirigees, 40 societes par personne) et global (max_nodes) : les troncatures sont signalees dans meta.truncated signale(dont unhub_directors pour les mandataires non etendus) - le graphe peut etre partiel.

Filtres : include_personnes (defaut true), include_sci (false = exclure les SCI), include_ceased (false = exclure les societes cessees), expand_persons.expand_persons (defaut true). La racine n'est jamais filtree.

Pour plusieurs entreprises, le parametre sirens sert 3 graphes en une requete, (2 en depth=2),depth=2. aCe depth=1plafond parest defautbas :parce unequ'une traversee a froid coute 3 a 5 secondes et ne se parallelise pas.pas sur le serving. Autre difference avec l'appel unitaire : le lot part a depth=1, la ou une societe seule part a depth=2.

 ⟨95 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨42 unchanged words⟩ 

 ⟨91 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨39 unchanged words⟩ 

 ⟨27 unchanged words⟩ , role, annee de naissance, date_debut_mandat, date_fin_mandat, linkedin_url
- **PM** (personne morale) : denomination,  ⟨38 unchanged words⟩  Utile pour identifier le mandataire actif vs sortant.

linkedin_url est le profil LinkedIn de la personne physique, present uniquement quand un profil a ete apparie avec certitude (nom + prenom + date de naissance). La clef est absente quand aucun profil n'est confirme : c'est le cas courant, pas une anomalie. Reserve au plan pro.

Par defaut, seuls les mandataires actifs sont  ⟨59 unchanged words⟩ 

 ⟨38 unchanged words⟩ "},{"type":"null"}]},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"nom":{"anyOf":[{"type":"string ⟨71 unchanged words⟩ "},{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today ⟨65 unchanged words⟩ 

Timeline unifiee des evenements d'UNE entreprise (par SIREN).

Flux chronologique decroissant qui reunit :
- uneFusionne lignecessions[] par+ annonceprocedures[] BODACC+ dedates modificationscalaires (forme juridique, dirigeants, siege, activite, capitaldepot_comptes, denominationaugmentation_capital, dissolution)
marche_public, avec libellesubvention, sous_type et source_url vers l'avis officiel ;
- une ligne par depot des comptes (un par exercice) et par immatriculation ;
- les cessions (y compris cote cedant d'une vente) et les procedures collectives ;
- la radiation, l'augmentation de capital, la creation ;
- une ligne par annee de marches publics, les subventions ;
- sur 12 mois, les mouvements de dirigeants et changements de groupe ou de) noteen creditun (typesflux dirigeant_*,chronologique changement_*).decroissant.

Pour plusieurs entreprises, le parametre sirens sert  ⟨24 unchanged words⟩ 

COUT : 1 appel de quota par societe. La timeline est vide pour la majorite des societes ; search_companies indique lesquelles portent des evenements de cession via include_fields=nb_cessions,derniere_cession_date.

 ⟨49 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨65 unchanged words⟩ 

 ⟨9 unchanged words⟩  : 1 appel de quota par societe, pour une reponse de ~10 a 45 Kio selon detail et years. PourPerimetre le: l'historique multi-annees et les postes detailles. Les agregats du seul dernier exercice (ca, ebitda, resultat_exploitation, resultat_net, effectif_moyen), search_companiesannee_financiere) lesont renddisponibles en include_fields sur search_companies, qui rend jusqu'a 20 societes par appel.

Pour plusieurs entreprises, le ⟨4 unchanged words⟩ 10 historiques en une requete (3 en detail=full, une reponse pesant alors ~330 Kio pour dix). LeDeux differences avec des appels un par un : le lot part en mode compact sauf demande explicite, y compris sur plan Pro, et il ne pagine pas.

Niveau deDefaut detailplan-aware :
- compactPlan (defautfree sur: free,mode `compact` (~40 champs par/ exercice) :. compteCompte de resultat complet (CA -> resultat net en passant par EBITDA, REX, financier, exceptionnel, IS), bilan abrege PCG (actif immobilise net, stocks, creances clients, disponibilites, total general actif, total actif ; capital social, reserves, report a nouveau, capitaux propres, provisions, dettes financieres, dettes fournisseurs, dettes fiscales/sociales, total dettes, total passif), ratios (tresorerie, dette nette, BFR, marges, ratio endettement, CAF, delais de paiement), dividendes verses, effectif moyen.
- fullPlan (defautpro sur: Pro,mode `full` par defaut (~140 champs / exercice, audit financier exhaustif). :Override tousexplicite lesvia postes.`detail=compact` Refusesi suron freeveut la vue resumee.

Mode `detail=full` (403).
-audit fieldsfinancier exhaustif) : ajouteretourne quelquesTOUS les champs afinanciers compactdisponibles sans(~140 gonflerpar laexercice). reponseSur plan gratuit, exrenvoie 403 upgrade_required ; sur plan Pro c'est le defaut.

Mode `fields` (recommande pour 1-5 ratios additionnels au-dessus de compact) : passer fields=["roe","bfr_jours_ca","autonomie_financiere"]. ajoute les champs cibles a chaque exercice sans gonfler la reponse. Plus de 130 champs disponibles : ratios (roe, taux_marge_brute, liquidite_generale, capacite_remboursement, etc.), postes detailles (achats_marchandises, salaires_traitements, etc.), immobilisations brutes (terrains_brut, constructions_brut, etc.), reserves (reserve_legale, croissancesprimes_emission_fusion_apport, etc.), croissance (cagr_ebitda_3ans...cagr_ebitda_3ans, cagr_rn_signed_5ans, etc.).

type_bilanBloc `ifrs` : Kpour consolide,les Csocietes socialcotees, Sretourne simplifie.en Quandplus laun fenetreobjet melangeifrs plusieursavec types,les unagregats seulcomptes estconsolides garde(chiffre_affaires, etebitda, type_bilan_mixtebpa, l'indiquedividendes, ;etc.).

Rendu type_bilan: forcela unreponse type.inclut Les`_layout`, coteesqui ontdecrit enpar plussection un(compte blocde ifrs.

Renduresultat, :bilan _layoutactif, decritbilan parpassif, sectionratios, dividendes, effectif) l'ordre PCG des lignes, leur libelle francais (line.label`line.label`), leur indentationniveau d'indentation (level`level`, 2 = lignes "dont ...") et leur nature (kind)`kind` ;: exercicesvalue, subtotal, total). `exercices[annee][line.key]` porte la valeur, ; null = poste absent.absent not_applicable_pcgde la source. `_layout.not_applicable_pcg: true` signale un plan comptable sectoriel (bilan deB banque, ouA d'assurance.assurance) ; `_layout.missing_pcg_lines` liste les lignes PCG absentes de notre source. Montants en euros.euros ; `_layout.doc_url` pointe la documentation du format.

 ⟨517 unchanged words⟩ },{"additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨48 unchanged words⟩ 

 ⟨233 unchanged words⟩ les signaux non retournes parce que le plan actuelFree ne donne acces qu'aux 10 signaux les plus recents, exactement comme la page /news. UnNe presente jamais un fil ainsi tronque n'est pascomme complet, et: hidden_by_plandis ditcombien de combien.signaux sont masques et que le plan Pro les ouvre.

Reponse : { news: [...], total ⟨21 unchanged words⟩ 

Rapprochement EN LOT de fiches mal identifiees (vers leur SIREN - la forme qu'un CRM, un tableur, ou un export CSV) verscontient.

Utiliser leurcet SIREN.

Aoutil utiliserquand pourl'utilisateur arrive avec une LISTE de societes a identifier ("voici 200 clients, retrouve lesleurs SIREN", de"rapproche cesce 200fichier", clients"nettoie ma base"). Pour UNE societe cherchee par son nom, utiliser search_companies, qui: il rend des resultats classes ;, celui-ci rend une decision,decision.

Difference etde refusenature avec search_companies : cet outil REFUSE de trancher quand il n'est pas sur.sur, et le dit. Il ne rend jamais un "meilleur resultat" par defaut.

Chaque fiche revient avec un status :
- resolved : SIREN certain.certain, exploitable directement.
- review    : plusieurs candidats plausibles ouOU nom trop generique ; les candidats sont retournes et le choix revient a l'utilisateur.
- no_match : aucune correspondance.

Le champ reason explique un review : ambiguous_candidates, weak_name_overlap, shared_domain (site partage par un reseau ;deux domain_company_countsocietes ditequivalentes, combienil defaut societesdepartager), fournirweak_name_overlap un(le nom oune unrecouvre codepas postal),assez missing_name,le invalid_domaincandidat), domain_no_matchmissing_name, lookup_failed (panne technique, a rejouer, - ce n'est PAS une absence de correspondance).

Conseils : domain (domaine ou URL) resout seul quand il designe une seule societe. Le code postal double quasiment le taux de rapprochement.rapprochement automatique. Un motjeton en trop dans le nom ("Carrefour Massy" au lieu de "Carrefour") nuitdegrade plus le rapprochement qu'un nom tronque.

Instantane Unet sans risque d'erreur quand la fiche porte deja un identifiant : un siren, un siret (les 9 premiers chiffres) ou un numero de TVA francais estsont resoluresolus sans aucune recherche.

COUT Le quota, lui, compte les fiches soumises : 1un appellot de quota200 parcoute fiche200 soumise,appels quelle que soit saleur forme.

Retourne results[] (ordredans l'ordre d'entree, avec l'id fourni s'il y en a un) et summary{total, resolved, review, no_match}. summary indique si le fichier est exploitable tel quel ou s'il demande un passage manuel.

 ⟨15 unchanged words⟩ items":{"additionalProperties":false,"properties":{"domain":{"description":"Site web de la societe, en domaine nu ou en URL complete. Tranche mieux qu'un nom quand il est connu.","maxLength":253,"type":"string"},"id":{"description":"Identifiant libre renvoye tel ⟨82 unchanged words⟩ ":200,"minItems":1,"type":"array"},"shared_domain":{"description":"Domaine porte par plusieurs societes : review (defaut) rend les candidats ; head rapproche vers la maison mere (groupe dominant, sinon plus gros CA), method=domain_head, confiance basse. Reserver aux colonnes d'enseignes.","enum":["review","head"],"type":"string"}},"required":["records"],"type":"object"}

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨123 unchanged words⟩ 

Recherche d'entreprises francaises par nom, SIREN/SIRETSIREN, activite, ouet criteres (geographiefinanciers.

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, secteurnb_marches_min→nb_marches_titulaire,montant_marches_titulaire, effectifnb_subventions_min→nb_subventions,montant_subventions_total, financiernb_brevets_min→nb_brevets,nb_brevets_actifs, dirigeantsnb_cessions_min→nb_cessions,derniere_cession_date, groupe).a_fusionne→a_fusionne, Pourest_societe_mission→est_societe_mission. uneSans societeinclude_fields, citeeles valeurs filtrees ne sont pas retournees.

Utiliser cet outil quand l'utilisateur cherche une entreprise par son nom :ou trouverveut leexplorer SIRENun ici,secteur.

Recherche puisde get_companydirigeant ou: get_financials.utiliser Effectifdirigeant_nom et+ statutdirigeant_prenom departagentpour filtrer les homonymes.

-entreprises Leayant sirenun dirigeant de ce nom. Ajouter dirigeant_naissance (YYYY-MM, granularite mois ; un YYYY-MM-DD est dansaccepte chaquemais resultatle jour est ignore) pour desambiguiser les homonymes. PERIMETRE : nece pasfiltre matche aussi les repasserdirigeants par"remontes" resolve_companiesdepuis (fichesune sanspersonne identifiantmorale representee (resolved_from_pm).
-, Valeursdonc :plus unlarge chiffreque les seuls mandats directs. Pour l'empreinte corporate DIRECTE d'UNE personne (ca,mandats ebitdadirects only, resultat_netdesambiguisation au jour pres, effectif_moyensortie centree personne avec le role par societe), signauxpreferer publics...search_director_companies. Filtrer par tranche d'age via age_dirigeant_max et advanced_filters (age_dirigeant_min). n'estAccepte retourneaussi queles s'ilSIRET figurea 14 chiffres dans include_fields,le memechamp quandquery.

Si ill'utilisateur sertdemande dedes filtre.informations 3sur champsune entreprise par rechercheson nom (freeex: "donne moi le CA de Vinci"), 10utiliser (pro).d'abord Uncet nomoutil inconnupour esttrouver listele dansSIREN, include_fields_unknownpuis :utiliser get_company ou get_financials avec le corrigerSIREN plutotobtenu. queLes d'appelerresultats get_companysont ligneclasses par ligne.pertinence get_financials; serteffectif l'historiqueet multi-annees.
-statut Filtresaident simplesa audepartager premierdes niveauhomonymes.

Une recherche peut etre enregistree avec les memes filtres via create_saved_search (suivi dans le temps, alerte optionnelle sur les deuxnouvelles 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 etavec effectif_max, ;et idemde meme pour ca, resultat_net, tresorerie, cagr_ca, date_creation, age_dirigeant).age_dirigeant. CriteresCes 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), CACcommissaires aux comptes, comptes) confidentiels/consolides - vivent dans l'objet advanced_filters, ;dont unele schema liste et type chaque cle. Une cle inconnue dans advanced_filters est rejetee (400).
-, Groupepas ignoree.

Organigramme d'un groupe : le filtre siren_groupe (valeur donneefournie par get_company) liste toutes les societes du groupe.
- Dirigeant

TRI : dirigeant_nomsort_by +parmi dirigeant_prenomrelevance (+ dirigeant_naissancedefaut). Inclut, leschiffre_affaires, dirigeantsresultat_net, remonteseffectif_moyen, viadate_creation, unecapital. personnesort_order moraleparmi ;asc, mandatsdesc directs(defaut d'unedesc). personneExemples : search_director_companies.
- Tri"les :10 sort_byplus (relevance,gros chiffre_affaires,CA" resultat_net,→ effectif_moyensort_by=chiffre_affaires, date_creation,"top capital)10 etpar sort_order.
-capital Cessionssocial" :→ include_fields=nb_cessionssort_by=capital,derniere_cession_date signale "les societesplus aanciennes" lire→ danssort_by=date_creation get_events.sort_order=asc.

20Non resultatsdisponible : le filtrage par profil LinkedIn des dirigeants.

Par defaut, maxretourne 20 resultats (max 20 free) ou/ 100 (pro par page). ;La pagination parest cursorreservee surau Pro.plan Pro.

COUT EN APPELS : une page est facturee 1 appel de quota par tranche de 20 lignes serviesservies. ;limit=20 lacoute 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 donneinclut "_user_plan" ("free" ou "pro"). include_fields est limite a 3 champs par recherche sur free et le10 quotasur restant.pro Pour; suivreles champs au-dela de la recherchelimite sont ignores et listes dans leinclude_fields_skipped. tempsUn nom de champ inconnu n'est pas une erreur : create_saved_search.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.

RetourneCOUT l'identiteET 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 basequota. 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, NAFcode_ape, localisationcode_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.

 ⟨1063 unchanged words⟩ },"include_fields":{"description":"Champs a ajouterinclure adans chaque resultat (CSV). Une valeur filtree n'apparaitpour que si son champ est demande. Montants et ratios : le champ porte leles nomvaleurs dud'un filtre sans _min/_max (ebitda_min -> ebitda, capitaux_propres_minfinancier ->ou capitaux_propres,donnees nb_cessions_minpubliques ->apparaissent. nb_cessions).Mapping Exceptionsfiltre→champ

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨168 unchanged words⟩ 

 ⟨91 unchanged words⟩  role_description, date_naissance, annee_naissance, lieu_naissance, type_personne, linkedin_url, entreprise { siren, denomination, ville, departement, code_ape } }. linkedin_url n'est present que si un profil a ete apparie avec certitude (plan pro) ; son absence est le cas courant, pas une anomalie. pagination { total (nb entreprises matchees), limit ⟨4 unchanged words⟩ meme nom+prenom recouvre souvent plusieurs personnes distinctes. date_naissance (et lieu_naissance) est le champ qui les distingue : deux  ⟨10 unchanged words⟩  non confirmee ; meme date = meme personne. La date est diffusee au MOIS (jour normalise a 01), conformement au regime de diffusion du registre : deux personnes nees le meme mois restent indistinguables.

Pour lister TOUTES les entreprises d'une personne donnee ⟨30 unchanged words⟩ 

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":{},"properties":{"_credits_remaining":{"type":"number"},"_quota_remaining_month":{"type":"number"},"_quota_remaining_today" ⟨31 unchanged words⟩ 

 ⟨67 unchanged words⟩ au moins un filtre region / departement / ville / code_naf, OU un filtre d'evenement
(date_min, date_max, cedant_siren, cessionnaire_siren, prix_min/max, tribunal, procedure_type) — sinon 400.

IMPORTANT : passer UN SEUL type quand la question porte sur un type precis. Les filtres de cadrage
(existence de l'evenement, fenetre de dates) ne sont pousses dans la requete que dans ce cas ; avec
plusieurs types ils s'excluraient mutuellement, et la recherche se rabat sur un tri general dont on
ne lit que les premieres pages — une question pointue y parait vide.

Cas d'usage :
- "Cessions de fonds > ⟨15 unchanged words⟩  collectives a Lyon" → type="procedure", ville="Lyon"
- "Liquidations prononcees a Marseille en juillet 2026" → type="procedure", procedure_type="liquidation", ville="Marseille", date_min="2026-07-01", date_max=departement="2026-07-3169"
- "Marches publics recents dans le BTP ⟨5 unchanged words⟩ 

 ⟨146 unchanged words⟩  Defaut : tous.","type":"string"},"ville":{"description":"Ville du siege (CSV possible). Ex: \"Marseille\". Le bon filtre pour un ressort de tribunal : plus etroit que departement.","type":"string"}},"type":"object"}

 ⟨13 unchanged words⟩ parametre sirens sert jusqu'a 10 fiches en une seule requete, au lieu d'un appel par societe.

 COUT : 1 appel de quota par societe, queen leslot societescomme soienta demandeesl'unite. unePour parcomparer unebeaucoup oude ensocietes, lot.search_companies Lesrend les memes champs, descriptifen d'activiteinclude_fields (dont description_activite) et site web (site_internet) compris, sont disponibles en include_fields sur search_companies, qui rend jusqu'a 20 societes par appel de quota. "_quota_remaining_today" indique le quota restant du compte.

Une societe peut etre mise sous surveillance via watch_company (alerte optionnelle sur les evenements futurs : procedures collectives, cessions, changements de dirigeants).appel.

Contenu de la fiche :
1. Identite —- forme juridique, date creation, date_immatriculation (RCS), date_cloture_exercice (JJ-MM, datedates de cloturecreation comptableet recurrente)d'immatriculation, denomination_usuelle si presentedate_cloture_exercice, capital social, siege (adresse complete rue+numero, code postal, departement, region)complet, activite (code NAF + libelle +, objet_social si disponible +, description si disponible), effectif. Le codeeffectif, LEI (Legal Entity Identifier) est expose au top-level pour les societes ayant un identifiant ESEF/GLEIF (typiquement les cotees). Sisi radieepresent :; successeur (siren,si denomination).radiee.
2. Financier —- date_cloture (annee) et type_bilan (K=consolideK consolide, C=complet/socialC social, S=simplifie)S simplifie : un CA en bilan K (consolide groupe) n'est pas comparable a un bilanCA C (social)., CA, croissance CA, resultat net, marge nette, EBITDAmarges, marge EBITDA, dette nette, effectif moyen.
3. Contact —- site web, telephone, email (pro),et LinkedIn (pro).
4. Gouvernance —- dirigeants principaux (president, DG), structure PM le cas echeant.principaux.
5. Groupe - appartenance a un groupe (est_filiale, nom du groupe), parentparents direct et ultime (denomination, SIREN, pays), societe_mere (holding mere directe : siren, denomination, pays, leitete -de sourcegroupe distincte(siren_groupe, souvent renseigneea quandpasser parent_direct/ultimea sontsearch_companies absents),pour tetelister dele groupe (est_tete_de_groupe, siren_groupe), nb filiales directes.filiales. Absent = independante.
6. IFRS — si disponible (societes cotees), donnees financieres consolidees IFRS : CA, resultat net, EBITDA, total actif. Absent pour- lesagregats societesconsolides nondes cotees.
7. Signaux —- cotation, procedures collectives (historique avec type, date, tribunal, jugement), a_fusionnefusions, modifications de capital, transferts de siege, changements de denomination, est_societe_missionESS, est_ess,societe reconstitution_capitaux_propres,a dernier_depot_datemission, comptesdernier confidentielsdepot, date radiation.
8. Score credit (credit_risk, tous plans) —- grade AAA ->a D, probabiliteprobabilites de defaut a 3/6/12 mois (taux du grade), 5 facteurs aggravants/attenuants,; datedetail dudans score.get_credit_risk. Null si la societe n'a pas de bilan recent (non scoree). Detail et explication : get_credit_risk.scoree.
8.9. Cessions — total, derniere_date,- historique[] (date, type, cedant, cessionnaire, activite, prix). Null si aucune.
9.10. Donnees publiques — marches_publics (nb,- montant,marches types)publics, subventions (nb, montant, regions), brevets (nb total, nb actifs), salons (nb participations, secteurs). Null si aucune donnee.salons.
10.11. Fonds d'investissement — bloc fonds si l'entreprise est detenue par un fonds (PE/VC) :- nom_fonds, siren_fonds (SIREN du fonds, permet de chainerchainable vers get_company), type_fonds, annee_entree_fonds, nb_fonds_actuels. Nullannee sinon.d'entree.

Pour approfondir : get_financials (historique multi-annees), get_directors (detail dirigeantsmandats), get_events (timelineannonces BODACC/evenementsBODACC), deget_company_graph l'entreprise(structure). watch_company met la societe sous surveillance.

Cartographie des entites autour d'UNE entreprise (par SIREN) : graphe ORIENTE et TYPEoriente construit sur les mandats RCS/RNE et les liens de groupe.

Utiliser cet outil pour visualiser ou analyserPour la structure d'un groupe : holdings, filiales, societes soeurs, dirigeants communs. Complementaire de get_directors (detail des mandats d'UNEd'une societe) et de search_director_companies (empreinte d'UNEd'une personne).

Reponse : nodes[] (entreprises et"co:<siren>", personnes physiques"pp:<nom>|<prenom>|<AAAA-MM>", parents etrangers "co:ext:<slug>") +et edges[] (aretes orientees source -> cible) :
- mandat_pm : societe dirigeante -> societe dirigee (role, est_actif ; dates de mandat en best-effort, souvent absentes)
- filiale : societe mere -> filiale (lien associe unique RNE, detention 100% implicite)
- parent_ultime : parent ultime (GLEIF, grands groupes) -> societe
- mandat_pp : personne physique -> societe dirigee (role)

Points cles :
- Les commissaires aux comptes sont EXCLUS des aretes (un CAC n'est pas de la gouvernance).
- Ids : entreprises "co:<siren>" ; personnes "pp:<nom>|<prenom>|<AAAA-MM>" (date de naissance en precision mois) ; parents etrangers horsA indexsavoir "co:ext:<slug>".
- Pas de pourcentagespourcentage de detention (nondetention. disponiblesLes danscommissaires lesaux sourcescomptes publiquessont utilisees).exclus.
- depth=1 : liens directs de la racine.directs. depth=2 (defaut) : expansion depuis les noeuds structurants (parents, et societes dirigeantes) -, jamais depuis les filiales pour eviter l'explosion sur les grands groupes.filiales.
- Expansion via les personnes (defaut ON, depth=2) : lesLes dirigeants de la RACINEracine tirent leurs AUTRESautres societes dans le graphe (holdings personnelles, SCI, structures soeurs d'un meme gerant = groupes de fait sans holding). Expansion depuis la racine uniquement, jamais depuis les niveaux suivants. Desactivable avec expand_persons=false pourdonne un graphe purement capitalistique.
- Garde hub-dirigeant : un dirigeant de la racine qui est unUn mandataire professionnel (expert-comptable / officier en serie) n'est PAS etendu - son portefeuille est un carnet de clients, pas le groupe. Detecte par un footprint eleve (plus de 50 societes dirigees) OU un mandat dansmandats, unou cabinet comptable/audit. Le dirigeant reste dans le graphe (il est officier declare de la racinecomptable) mais ses autres societes ne sontn'est pas tirees. Ces dirigeants sontetendu listes: dansvoir meta.truncated.hub_directors.
- CapsPlafonds par noeud (20 filiales, 20 societes dirigees, 40 societes par personne) et global (max_nodes) : les troncatures sont signalees dans meta.truncated (dont hub_directors pour les mandataires non etendus) -signale leun graphe peut etre partiel.

Filtres : include_personnes (defaut true), include_sci (false = exclure les SCI), include_ceased (false = exclure les societes cessees), expand_persons (defaut true).expand_persons. La racine n'est jamais filtree.

Pour plusieurs entreprises, le parametre sirens sert 3 graphes en une requete, (2 en depth=2.depth=2), Cea plafonddepth=1 estpar basdefaut parce: qu'uneune traversee a froid coute 3 a 5 secondes et ne se parallelise pas sur le serving. Autre difference avec l'appel unitaire : le lot part a depth=1, la ou une societe seule part a depth=2.pas.

Timeline unifiee des evenements d'UNE entreprise (par SIREN).

FusionneFlux cessions[]chronologique +decroissant procedures[]qui +reunit dates:
- scalairesune ligne par annonce BODACC de modification (depot_comptesforme juridique, augmentation_capitaldirigeants, siege, activite, capital, denomination, dissolution), avec libelle, sous_type et source_url vers l'avis officiel ;
marche_public- les cessions et procedures collectives ;
- le dernier depot des comptes (cloture, subventionnb_depots_total), la radiation, l'augmentation de capital, la creation) en;
- unune fluxligne chronologiquepar decroissant.annee de marches publics, les subventions ;
- sur 12 mois, les mouvements de dirigeants et changements de groupe ou de note credit (types dirigeant_*, changement_*).

Pour plusieurs entreprises, le parametre sirens sert  ⟨24 unchanged words⟩ 

COUT : 1 appel de quota par societe. La timeline est vide pour la majorite des societes ; search_companies indique lesquelles portent des evenements de cession via include_fields=nb_cessions,derniere_cession_date.