search_companies

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "description": "Nom, SIREN, mot-cle activite, ou \"*\" pour rechercher uniquement par filtres. Operateurs acceptes : \"expression exacte\", OR en majuscules (ou |) entre deux termes, -terme pour exclure, parentheses pour grouper. Ex : (logiciel OR saas) \"gestion de paie\" -holding"
    },
    "region": {
      "description": "Region. Ex: \"Ile-de-France\", \"Bretagne\", \"Auvergne-Rhone-Alpes\"",
      "type": "string"
    },
    "departement": {
      "description": "Code departement. Ex: \"75\", \"33\", \"69\"",
      "type": "string"
    },
    "ville": {
      "description": "Nom de ville. Plusieurs villes separees par virgule. Ex: \"Paris,Lyon,Bordeaux\"",
      "type": "string"
    },
    "code_naf": {
      "description": "Code NAF/APE. Exemples courants :\n- SaaS/Logiciel : 5829C, 6201Z, 6202A\n- Conseil IT : 6202A, 6209Z\n- Conseil management : 7022Z\n- Fintech : 6419Z, 6499Z\n- Biotech/Pharma : 2120Z, 7211Z\n- E-commerce : 4791A, 4791B\n- BTP : 4120A, 4120B\n- Restauration : 5610A, 5610C\nPlusieurs codes separes par virgule.",
      "type": "string"
    },
    "statut": {
      "description": "Filtre par statut au registre. DISSOLVED = dissoute ou radiee ; une societe en procedure collective reste ACTIVE jusqu'a sa radiation. Le statut ne se deduit PAS de date_radiation, absente sur environ 9,9M des 12,4M societes dissoutes.",
      "type": "string",
      "enum": [
        "ACTIVE",
        "DISSOLVED"
      ]
    },
    "effectif_min": {
      "description": "Effectif minimum (nombre de salaries)",
      "type": "number"
    },
    "ca_min": {
      "description": "CA minimum en euros. Ex: 5000000 pour 5M",
      "type": "number"
    },
    "resultat_net_min": {
      "description": "Resultat net minimum en euros",
      "type": "number"
    },
    "tresorerie_min": {
      "description": "Tresorerie minimum en euros",
      "type": "number"
    },
    "cagr_ca_min": {
      "description": "Croissance CA min sur 1 an en % (ex: 20 pour +20%)",
      "type": "number"
    },
    "date_creation_min": {
      "description": "Date de creation minimum (ISO). Ex: \"2021-01-01\" pour les entreprises creees apres 2021",
      "type": "string"
    },
    "age_dirigeant_max": {
      "description": "Age maximum des dirigeants (annees). Ex: 50 pour moins de 50 ans. Filtre si au moins un dirigeant correspond.",
      "type": "number"
    },
    "is_cotee": {
      "description": "true pour les societes cotees en bourse uniquement, false pour les exclure",
      "type": "boolean"
    },
    "credit_grade": {
      "description": "Grades de risque credit a garder (OR). Ex: [\"CCC\",\"D\"] pour les societes a risque eleve, [\"AAA\",\"AA\"] pour les plus solides. ~900k societes scorees (celles avec un bilan recent) ; les non scorees sont exclues des qu'un grade est demande.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "AAA",
          "AA",
          "A",
          "BBB",
          "BB",
          "B",
          "CCC",
          "D"
        ]
      }
    },
    "credit_scored": {
      "description": "true pour ne garder que les societes qui ont un score credit, false pour les exclure",
      "type": "boolean"
    },
    "code_postal": {
      "description": "Code postal du siege. Ex: \"75001\", \"69001\". Plusieurs separes par virgule.",
      "type": "string"
    },
    "latitude": {
      "description": "Latitude du centre pour une recherche par rayon (WGS84). A fournir avec longitude ET radius.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "description": "Longitude du centre pour une recherche par rayon (WGS84). A fournir avec latitude ET radius.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius": {
      "description": "Rayon de recherche en km (1-200) autour de latitude/longitude. Les trois vont ensemble : un triplet incomplet est refuse.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "procedure_collective": {
      "description": "Procedure collective EN COURS (etat courant, pas l'historique). Valeurs: \"liquidation\", \"redressement\", \"sauvegarde\", \"conciliation\", \"autre\", \"accord_homologue\", \"plan_redressement\", \"plan_sauvegarde\", \"plan_cession\". Plusieurs separes par virgule. \"accord_homologue\" = accord de conciliation homologue en cours d'execution, ce qui CLOT la conciliation et ne l'ouvre pas ; \"conciliation\" ne designe qu'une ouverture, que le BODACC ne publie pas. Une procedure cloturee ne matche pas : les societes dont la liquidation est close en sont exclues.",
      "type": "string"
    },
    "plan_en_cours": {
      "description": "Societes executant un plan (redressement, sauvegarde ou cession). Distinct de procedure_collective : sous plan, la periode d'observation est terminee.",
      "type": "boolean"
    },
    "dirigeant_nom": {
      "description": "Nom de famille du dirigeant (recherche exacte). Ex: \"GUILLEMOT\". Combine avec dirigeant_prenom et dirigeant_naissance pour desambiguiser les homonymes.",
      "type": "string"
    },
    "dirigeant_prenom": {
      "description": "Prenom du dirigeant. A utiliser avec dirigeant_nom. Ex: \"Yves\"",
      "type": "string"
    },
    "dirigeant_naissance": {
      "description": "Naissance du dirigeant pour desambiguiser les homonymes, granularite mois : format YYYY-MM. Ex: \"1975-03\" (un YYYY-MM-DD est accepte mais le jour est ignore). Pour une desambiguisation au jour pres, utiliser search_director_companies.",
      "type": "string"
    },
    "has_website": {
      "description": "true pour ne retourner que les entreprises ayant un site web",
      "type": "boolean"
    },
    "est_filiale": {
      "description": "true = filiales uniquement, false = entreprises independantes uniquement",
      "type": "boolean"
    },
    "independant_strict": {
      "description": "true = uniquement les societes reellement independantes : exclut les filiales declarees ET les societes avec un soupcon de groupe fort (groupe_pont probable). Les soupcons plus faibles (possible/soupcon) ne sont pas exclus.",
      "type": "boolean"
    },
    "appartient_groupe": {
      "description": "true = uniquement les societes appartenant a un groupe : filiales declarees OU soupcon de groupe fort (groupe_pont probable). Complement exact de independant_strict (ne pas envoyer les deux en meme temps).",
      "type": "boolean"
    },
    "groupe_pont_siren": {
      "description": "SIREN de la tete de groupe INFEREE (soupcon de groupe via dirigeant-pont). Retourne toutes les societes rattachees au meme groupe soupconne (non declare). A distinguer de siren_groupe (lien capitalistique declare).",
      "type": "string"
    },
    "est_tete_de_groupe": {
      "description": "true = uniquement les tetes de groupe",
      "type": "boolean"
    },
    "siren_groupe": {
      "description": "SIREN de la tete de groupe. Retourne toutes les societes du meme groupe. Ex: \"352383715\" pour lister toutes les filiales de LVMH.",
      "type": "string"
    },
    "groupe_parent": {
      "description": "Nom du groupe parent (recherche textuelle). Ex: \"LVMH\", \"Bouygues\"",
      "type": "string"
    },
    "societe_mere_etrangere": {
      "description": "true = filiales de groupes etrangers uniquement",
      "type": "boolean"
    },
    "filter_annee": {
      "description": "Annee de l'exercice financier. Filtre les entreprises dont le dernier bilan publie correspond a cette annee. Ex: 2024 pour ne voir que les bilans 2024. Combiner avec ca_min pour \"societes ayant fait 5M de CA en 2024\".",
      "type": "number"
    },
    "effectif_max": {
      "description": "Effectif maximum (nombre de salaries)",
      "type": "number"
    },
    "ca_max": {
      "description": "CA maximum en euros. Ex: 50000000 pour 50M",
      "type": "number"
    },
    "resultat_net_max": {
      "description": "Resultat net maximum en euros",
      "type": "number"
    },
    "tresorerie_max": {
      "description": "Tresorerie maximum en euros",
      "type": "number"
    },
    "cagr_ca_max": {
      "description": "Croissance CA max sur 1 an en % (ex: 50 pour +50%)",
      "type": "number"
    },
    "date_creation_max": {
      "description": "Date de creation maximum (ISO). Ex: \"2021-12-31\" pour les entreprises creees avant 2022",
      "type": "string"
    },
    "age_dirigeant_min": {
      "description": "Age minimum des dirigeants (annees). Ex: 60 pour 60 ans et plus. Filtre si au moins un dirigeant correspond.",
      "type": "number"
    },
    "advanced_filters": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "ca_max": {
              "description": "CA maximum (euros)",
              "type": "number"
            },
            "resultat_net_max": {
              "description": "Resultat net maximum",
              "type": "number"
            },
            "ebitda_min": {
              "description": "EBITDA minimum",
              "type": "number"
            },
            "ebitda_max": {
              "description": "EBITDA maximum",
              "type": "number"
            },
            "resultat_exploitation_min": {
              "type": "number"
            },
            "resultat_exploitation_max": {
              "type": "number"
            },
            "marge_brute_min": {
              "type": "number"
            },
            "marge_brute_max": {
              "type": "number"
            },
            "valeur_ajoutee_min": {
              "type": "number"
            },
            "valeur_ajoutee_max": {
              "type": "number"
            },
            "tresorerie_max": {
              "type": "number"
            },
            "capitaux_propres_min": {
              "type": "number"
            },
            "capitaux_propres_max": {
              "type": "number"
            },
            "total_actif_min": {
              "type": "number"
            },
            "total_actif_max": {
              "type": "number"
            },
            "dettes_financieres_min": {
              "type": "number"
            },
            "dettes_financieres_max": {
              "type": "number"
            },
            "dettes_fournisseurs_min": {
              "type": "number"
            },
            "dettes_fournisseurs_max": {
              "type": "number"
            },
            "dette_nette_min": {
              "type": "number"
            },
            "dette_nette_max": {
              "type": "number"
            },
            "bfr_min": {
              "type": "number"
            },
            "bfr_max": {
              "type": "number"
            },
            "capital_min": {
              "description": "Capital social minimum",
              "type": "number"
            },
            "capital_max": {
              "description": "Capital social maximum",
              "type": "number"
            },
            "dividendes_min": {
              "type": "number"
            },
            "dividendes_max": {
              "type": "number"
            },
            "capacite_autofinancement_min": {
              "type": "number"
            },
            "capacite_autofinancement_max": {
              "type": "number"
            },
            "marge_nette_min": {
              "type": "number"
            },
            "marge_nette_max": {
              "type": "number"
            },
            "marge_ebitda_min": {
              "type": "number"
            },
            "marge_ebitda_max": {
              "type": "number"
            },
            "ratio_endettement_min": {
              "type": "number"
            },
            "ratio_endettement_max": {
              "type": "number"
            },
            "cagr_ca_max": {
              "type": "number"
            },
            "cagr_ca_2ans_min": {
              "type": "number"
            },
            "cagr_ca_2ans_max": {
              "type": "number"
            },
            "cagr_ca_3ans_min": {
              "type": "number"
            },
            "cagr_ca_3ans_max": {
              "type": "number"
            },
            "cagr_ca_5ans_min": {
              "type": "number"
            },
            "cagr_ca_5ans_max": {
              "type": "number"
            },
            "cagr_ebitda_1an_min": {
              "type": "number"
            },
            "cagr_ebitda_1an_max": {
              "type": "number"
            },
            "cagr_ebitda_2ans_min": {
              "type": "number"
            },
            "cagr_ebitda_2ans_max": {
              "type": "number"
            },
            "cagr_ebitda_3ans_min": {
              "type": "number"
            },
            "cagr_ebitda_3ans_max": {
              "type": "number"
            },
            "cagr_ebitda_5ans_min": {
              "type": "number"
            },
            "cagr_ebitda_5ans_max": {
              "type": "number"
            },
            "cagr_rn_1an_min": {
              "type": "number"
            },
            "cagr_rn_1an_max": {
              "type": "number"
            },
            "cagr_rn_2ans_min": {
              "type": "number"
            },
            "cagr_rn_2ans_max": {
              "type": "number"
            },
            "cagr_rn_3ans_min": {
              "type": "number"
            },
            "cagr_rn_3ans_max": {
              "type": "number"
            },
            "cagr_rn_5ans_min": {
              "type": "number"
            },
            "cagr_rn_5ans_max": {
              "type": "number"
            },
            "effectif_max": {
              "description": "Tranche INSEE maximum",
              "type": "number"
            },
            "effectif_moyen_min": {
              "description": "Effectif exact des bilans, minimum",
              "type": "number"
            },
            "effectif_moyen_max": {
              "type": "number"
            },
            "delai_paiement_clients_jours_min": {
              "type": "number"
            },
            "delai_paiement_clients_jours_max": {
              "type": "number"
            },
            "delai_paiement_fournisseurs_jours_min": {
              "type": "number"
            },
            "delai_paiement_fournisseurs_jours_max": {
              "type": "number"
            },
            "date_creation_max": {
              "type": "string"
            },
            "date_radiation_min": {
              "type": "string"
            },
            "date_radiation_max": {
              "type": "string"
            },
            "derniere_cession_date_min": {
              "type": "string"
            },
            "derniere_cession_date_max": {
              "type": "string"
            },
            "cac_date_debut_mandat_min": {
              "description": "Date de debut de mandat du commissaire aux comptes (titulaire ou suppleant), minimum",
              "type": "string"
            },
            "cac_date_debut_mandat_max": {
              "type": "string"
            },
            "age_dirigeant_min": {
              "description": "Age minimum (annees)",
              "type": "number"
            },
            "civilite_dirigeant": {
              "description": "Genre du dirigeant. Au moins un dirigeant doit correspondre.",
              "type": "string",
              "enum": [
                "homme",
                "femme",
                "M",
                "Mme",
                "H",
                "F"
              ]
            },
            "nb_filiales_directes_min": {
              "type": "number"
            },
            "nb_filiales_directes_max": {
              "type": "number"
            },
            "comptes_confidentiels": {
              "description": "true = comptes confidentiels, false = comptes publies",
              "type": "boolean"
            },
            "comptes_consolides": {
              "description": "true = consolides, false = sociaux uniquement",
              "type": "boolean"
            },
            "data_freshness": {
              "description": "Fraicheur des bilans en annees. Ex: 2 pour bilans < 2 ans",
              "type": "number"
            },
            "categorie_juridique": {
              "description": "Code INSEE de categorie juridique, plusieurs separes par virgule. Ex: \"5710\" SAS, \"5720\" SASU, \"5599\" SA, \"5499\" SARL",
              "type": "string"
            },
            "nb_cessions_min": {
              "type": "number"
            },
            "nb_cessions_max": {
              "type": "number"
            },
            "a_fusionne": {
              "description": "true = a participe a une fusion",
              "type": "boolean"
            },
            "nb_marches_min": {
              "description": "\"entreprises avec marches publics\" -> 1",
              "type": "number"
            },
            "nb_marches_max": {
              "type": "number"
            },
            "nb_subventions_min": {
              "description": "\"entreprises subventionnees\" -> 1",
              "type": "number"
            },
            "nb_brevets_min": {
              "description": "\"entreprises avec brevets\" -> 1",
              "type": "number"
            },
            "est_societe_mission": {
              "type": "boolean"
            },
            "est_ess": {
              "description": "true = economie sociale et solidaire",
              "type": "boolean"
            },
            "a_fonds": {
              "description": "true = detenue par un fonds d'investissement PE/VC",
              "type": "boolean"
            }
          },
          "additionalProperties": false,
          "description": "Filtres avances. Rappel include_fields : nb_marches_min -> nb_marches_titulaire,montant_marches_titulaire ; nb_subventions_min -> nb_subventions,montant_subventions_total ; nb_brevets_min -> nb_brevets,nb_brevets_actifs ; dividendes_min -> dividendes_verses."
        },
        {
          "type": "string",
          "description": "DEPRECATED - JSON serialise des memes cles. Preferer l'objet typé."
        }
      ]
    },
    "sort_by": {
      "description": "Tri des resultats. Par defaut \"relevance\". Ex: \"chiffre_affaires\" pour trier par CA.",
      "type": "string",
      "enum": [
        "relevance",
        "chiffre_affaires",
        "resultat_net",
        "effectif_moyen",
        "date_creation",
        "capital"
      ]
    },
    "sort_order": {
      "description": "Ordre de tri. Par defaut \"desc\". Ex: \"asc\" pour les plus petits CA en premier.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Nombre de resultats par page (defaut 20 ; max 20 sur free, 100 sur pro). Facture 1 appel de quota par tranche de 20 lignes : limit=100 coute 5 appels.",
      "type": "number"
    },
    "cursor": {
      "description": "Curseur de pagination retourne dans next_cursor de la reponse precedente. Ne pas fournir pour la premiere page.",
      "type": "string"
    },
    "include_fields": {
      "description": "Champs a ajouter a chaque resultat (CSV). Une valeur filtree n'apparait que si son champ est demande. Montants et ratios : le champ porte le nom du filtre sans _min/_max (ebitda_min -> ebitda, capitaux_propres_min -> capitaux_propres, nb_cessions_min -> nb_cessions). Exceptions : dividendes_min -> dividendes_verses ; nb_marches_min -> nb_marches_titulaire,montant_marches_titulaire ; nb_subventions_min -> nb_subventions,montant_subventions_total ; nb_brevets_min -> nb_brevets,nb_brevets_actifs.\nFinancier : ca, marge_brute, valeur_ajoutee, ebitda, resultat_exploitation, resultat_net, marge_nette, marge_ebitda, total_actif, capitaux_propres, tresorerie, dettes_financieres, dettes_fournisseurs, dette_nette, bfr, ratio_endettement, capacite_autofinancement, dividendes_verses, delai_paiement_clients_jours, delai_paiement_fournisseurs_jours, effectif_moyen, annee_financiere.\nCroissance : croissance_ca, croissance_ebitda, croissance_rn, et leurs variantes _2ans, _3ans, _5ans.\nGroupe : est_filiale, est_tete_de_groupe, groupe_parent, siren_groupe, nb_filiales_directes, societe_mere_etrangere.\nSignaux BODACC : nb_cessions, derniere_cession_date, a_fusionne, nb_modifications_capital, nb_transferts_siege, nb_changements_denomination, nb_evt_modif_admin.\nDonnees publiques : nb_marches_titulaire, montant_marches_titulaire, nb_subventions, montant_subventions_total, nb_brevets, nb_brevets_actifs, nb_participations_salons, est_societe_mission, est_ess.\nFonds PE/VC : a_fonds, nom_fonds, siren_fonds, type_fonds, annee_entree_fonds, nb_fonds_actuels.\nCotees : a_lei, lei, source_esef, source_gleif, nb_instruments_financiers.\nCompteurs et fraicheur : nb_dirigeants, nb_etablissements, nb_representants_actifs, derniere_evt_date, dernier_depot_date, dernier_marche_date.\nTexte : description_activite (alias description ; reprend souvent le libelle NAF), objet_social, site_internet (~40 % des societes a CA > 8 M EUR). Le descriptif est deja cherche par query.\nPlan gratuit : ca, resultat_net, effectif_moyen, croissance_ca, annee_financiere, plus les champs groupe, signaux, donnees publiques et texte.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}