search_directors
Recherche de personnes (dirigeants) à travers toutes les sociétés françaises, par nom de famille.
À la différence de search_companies (qui retourne des ENTREPRISES et accepte dirigeant_nom/dirigeant_prenom comme filtres), search_directors retourne directement des PERSONNES avec leur société de rattachement. Cas d'usage : "toutes les sociétés où siège un dirigeant nommé DUPONT", cartographie d'un réseau de mandats.
Paramètres : nom (REQUIS, nom de famille), prenom (optionnel, désambiguïse), role (optionnel, ex "Président", "Gérant", "Administrateur"). Par défaut seuls les mandats actifs ; include_inactive=true pour inclure les anciens mandats.
Réponse : data[] = personnes { nom, prenom, civilite, role, role_description, date_naissance, annee_naissance, lieu_naissance, type_personne, linkedin_url, entreprise { siren, denomination, ville, departement, code_ape } }. linkedin_url n'est présent que si un profil a été apparié avec certitude (plan pro) ; son absence est le cas courant, pas une anomalie. pagination { total (nb sociétés matchées), limit, returned }.
Homonymes : un même nom+prénom recouvre souvent plusieurs personnes distinctes. date_naissance est le champ qui les distingue : deux dates différentes = deux personnes ; date absente = identité non confirmée ; même date = même personne. La date est diffusée au MOIS (jour normalisé à 01), conformément au régime de diffusion du registre : deux personnes nées le même mois restent indistinguables.
Pour lister TOUTES les sociétés d'une personne donnée une fois sa date de naissance connue, enchaîner avec search_director_companies (nom + prénom + date_naissance). Pour la fiche complète d'un dirigeant d'une société donnée, utiliser get_directors avec le SIREN.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nom | Yes | Nom de famille du dirigeant recherché (requis). | |
| role | No | Role/qualite (optionnel), ex: 'Président', 'Gérant', 'Administrateur'. | |
| limit | No | Nombre de sociétés à scanner (défaut 20, max 50). | |
| prenom | No | Prénom (optionnel) pour désambiguïser les homonymes. | |
| include_inactive | No | Inclure les mandats inactifs (par défaut : false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| _user_plan | No | ||
| pagination | No | ||
| _credits_remaining | No | ||
| _quota_remaining_month | No | ||
| _quota_remaining_today | No |