--- title: "Exporter des personnes (CSV)" method: POST path: "/people/export" tags: ["Personnes"] --- # Exporter des personnes (CSV) `POST /people/export` ## Request - Base URL: `https://api.basile.cc` - URL: `https://api.basile.cc/people/export` - Auth: API key in header `Authorization` Exporte un CSV enrichi (92 colonnes : identité, poste, profil LinkedIn, société, légal, GMB, contacts). Accepte les **mêmes `filters`** que `/find`, ou une liste d'`ids`. Plafonné par le plan (header `X-Export-Max-Rows`). L'export est **streamé** (parcours du résultat par curseur, écriture au fil de l'eau) : un seul appel par `filters` suffit jusqu'à la limite par export du plan — pas besoin de pré-collecter les IDs. Au-delà de cette limite, découper la recherche en segments (département / NAF / année…) et faire un export par segment. L'export par `ids` reste utile quand on a déjà collecté une liste (via `/find` `idsOnly`) pour un ré-enrichissement par lots ou une sélection. ## Request body - union - ExportByFilters - `filters` union, required - FindPeopleFilters: Filtres de recherche de personnes. Deux sources : **Legal** (registre) et **LKI** (LinkedIn). Activer un filtre Legal-only exclut LinkedIn, et inversement (voir descriptions). - `result_full_name` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_first_name` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_last_name` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_role` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `activity` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `company_headcount` RangeFilter: Filtre numérique (bornes). Tous les opérateurs sont optionnels. - `>` number - `>=` number - `<` number - `<=` number - `employer` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_city` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_country_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `mandate_role` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `siren` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `legal_name` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `nationality` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `nationality_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_postal_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `result_is_legal_entity` boolean: Legal-only. La 'personne' est une personne morale. - `result_is_current` boolean: Legal-only. Mandat actuel uniquement. - `result_age` RangeFilter: Filtre numérique (bornes). Tous les opérateurs sont optionnels. - `>` number - `>=` number - `<` number - `<=` number - `result_total_companies_count` RangeFilter: Filtre numérique (bornes). Tous les opérateurs sont optionnels. - `>` number - `>=` number - `<` number - `<=` number - `current_seniority` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `current_job_functions` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `skills` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `languages` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `education` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `past_title` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `past_employer` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `connection_count` RangeFilter: Filtre numérique (bornes). Tous les opérateurs sont optionnels. - `>` number - `>=` number - `<` number - `<=` number - `current_tenure_years` RangeFilter: Filtre numérique (bornes). Tous les opérateurs sont optionnels. - `>` number - `>=` number - `<` number - `<=` number - `linkedin_url` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `source` 'Legal' | 'LKI': Forcer une seule source. - `with_legal_data` boolean: Restreint la recherche à la source Registre (équivaut à source=Legal). Attention : sur /companies/find, le filtre du même nom ne restreint PAS la source, c'est un filtre ET. - `with_linkedin_profile` boolean: Restreint la recherche à la source LinkedIn (équivaut à source=LKI). Si les deux bascules sont vraies, with_legal_data l'emporte. - `hide_legal_entities` boolean: Masque les personnes morales (recommandé : true) sans exclure LinkedIn. - FindCompaniesFilters: Filtres de recherche d'entreprises. Trois sources : **Legal** (registre), **LKI** (LinkedIn), **GMB** (Google My Business). - `name` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `activity` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `naf_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headquarters_department_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headquarters_region_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headquarters_postal_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headquarters_city` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headquarters_country_code` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `legal_form` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `legal_category` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `siren` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `headcount_min` integer: Effectif minimum (Legal + LKI). - `headcount_max` integer: Effectif maximum (Legal + LKI). - `capital_min` number: Legal-only. Capital social min (€). - `capital_max` number: Legal-only. Capital social max (€). - `company_ceased` boolean: false = actives uniquement (recommandé). true = cessées. - `publishable` boolean: Legal-only. Diffusable. - `with_procedure` boolean: Legal-only (restreint la recherche au registre). true = la société a connu une procédure collective, en cours ou clôturée, d'après les jugements publiés au BODACC (546 592 sociétés). false = aucune procédure connue, ni en cours ni clôturée. - `procedure_open` boolean: Legal-only (restreint la recherche au registre). true = procédure en cours, plans de redressement et de sauvegarde en cours d'exécution compris (168 250 sociétés, dont 150 544 encore actives). false = écarte les procédures en cours : garde les sociétés sans procédure et celles dont la procédure est clôturée. - `procedure_type` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `idcc` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `created_since_months` number: Legal-only. Entreprises créées dans les N DERNIERS MOIS (ex. 3). Plus précis que creation_date_*, qui raisonne en années civiles. - `creation_date_min` string: Legal-only. ANNÉE de création min (2015 ou '2015'). ⚠️ JAMAIS de date complète ('2015-03-01') : elle serait SILENCIEUSEMENT ignorée (résultats non filtrés). - `creation_date_max` string: Legal-only. ANNÉE de création max (année seule, pas de date complète). - `industry_main` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `company_type` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `domain` IncludeExcludeFilter: Filtre texte. `include` = OR entre les valeurs (au moins une matche). `exclude` = exclut toute valeur qui matche. Les deux peuvent être combinés. Plusieurs filtres distincts se combinent en **ET**. - `include` string[] - `exclude` string[] - `followers_min` integer: LKI-only. Followers LinkedIn min. - `followers_max` integer: LKI-only. Followers LinkedIn max. - `rating_min` number: GMB-only. Note Google min (0-5). - `rating_max` number: GMB-only. Note Google max. - `reviews_min` integer: GMB-only. Nb d'avis min. - `reviews_max` integer: GMB-only. Nb d'avis max. - `is_opening` boolean: GMB-only. Ouvert le dimanche. - `source` 'Legal' | 'LKI' | 'GMB': Forcer une seule source. - `with_legal_data` boolean: Filtre ET, PAS un choix de source : garde les entreprises qui ont AUSSI une fiche au registre. Les trois sources restent interrogées, chacune filtrée. Pour ne lire que le registre, utiliser source=Legal. - `with_linkedin_page` boolean: Filtre ET, PAS un choix de source : garde les entreprises qui ont AUSSI une page LinkedIn. Pour ne lire que LinkedIn, utiliser source=LKI. - `with_email` boolean: Filtre ET : garde les entreprises pour lesquelles nous avons une adresse email d'entreprise, relevée sur leur site. - `with_phone` boolean: Filtre ET : garde les entreprises pour lesquelles nous avons un numéro de téléphone d'entreprise (standard de la fiche Google Maps, ou numéro affiché sur le site) ; ce n'est pas le mobile d'une personne. La source LinkedIn ne répond pas encore à ce filtre et renvoie 0 : résultats incomplets, jamais faux. - ExportByIds - `ids` string[], required: IDs renvoyés par `/find` (champ `_id` de chaque lead). ## Response `200` Fichier CSV. ## Other responses - `400`: Aucun filtre effectif. Une clé d'API doit poser au moins un filtre qui restreint réellement le résultat. Ne comptent pas : filters vide, {"include":[]}, null, "", une clé inconnue, et source seul. - `401`: Clé API absente ou invalide. - `403`: Clé réservée à l'enrichissement (compte à crédits sans forfait API) utilisée hors de /enrichment. - `429`: Quota d'export mensuel atteint, ou rate limit. --- [API](https://skmtc.dev/basile/apis/basile-api.md) · [All operations](https://skmtc.dev/basile/apis/basile-api/llms.txt) · [OpenAPI document](https://skmtc.dev/basile/apis/basile-api/revisions/f260fbfcc5eb?raw)