Entreprises

Rechercher des entreprises

Recherche de sociétés sur les trois sources (registre, LinkedIn, GMB). Pour compter sans extraire ni être facturé, envoyer countOnly: true (ou limit: 0) : la réponse contient total et un leads vide. Sinon, chaque enregistrement renvoyé coûte 1 crédit. Les résultats rattachés au registre portent data.procedure_statut : le statut de procédure collective calculé sur les jugements publiés au BODACC (code, depuis, tribunal, organes, plan_duree_ans, source…), absent quand la société n'a jamais connu de procédure. C'est code qui distingue un plan (plan_redressement, plan_sauvegarde) d'une période d'observation (redressement, sauvegarde) : aucun filtre ne le fait.

post/companies/find

Request

Base URL: https://api.basile.cc
URL: https://api.basile.cc/companies/find
Auth: API key in header Authorization

Request body

limitinteger

Taille de page (défaut 100). Cap = 1000 en mode normal ; 5000 en mode idsOnly côté /people/find (companies reste à 1000). 0 = compter seulement (équivalent à countOnly: true, gratuit). ⚠️ 1 n'est PAS un mode de comptage : cela renvoie 1 enregistrement, donc 1 crédit — utiliser countOnly.

countOnlyboolean

Si true, /find ne renvoie que le total avec un tableau leads vide : c'est le mode de comptage gratuit (aucun enregistrement renvoyé, donc aucun crédit débité), quel que soit le nombre de résultats. Équivalent à limit: 0. À utiliser systématiquement pour cadrer un volume avant d'extraire.

paginationTokenstring

Curseur opaque renvoyé dans pagination.nextToken pour la page suivante.

idsOnlyboolean

Si true, /find ne renvoie que { _id, source } (champ data vide), sans enrichissement par ligne — beaucoup plus léger et rapide pour collecter les IDs d'un grand résultat. Permet limit jusqu'à 5000 côté /people/find. À utiliser quand on a besoin de la liste d'IDs avant un export par { ids } ou un ré-enrichissement par lots. Pour un simple CSV, préférer /export par filters (export streamé, jusqu'à la limite par export du plan).

Example request

{
  "filters": {
    "name": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "activity": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "naf_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "headquarters_department_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "headquarters_region_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "headquarters_postal_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "headquarters_city": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "headquarters_country_code": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "legal_form": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "legal_category": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "siren": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "procedure_type": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "idcc": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "industry_main": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "company_type": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    },
    "domain": {
      "include": [
        "Directeur Commercial",
        "Sales Director"
      ],
      "exclude": [
        "assistant"
      ]
    }
  }
}

Response

Résultats paginés.

successboolean

totalinteger

Total de résultats (somme des sources, sans dédup cross-source).

Example response

{
  "leads": [
    {
      "mandate": {
        "label": "Président de X via HOLDING Y"
      }
    }
  ],
  "meta": {
    "warnings": [
      {
        "code": "company_role_absent",
        "message": "ALTRAD ARNHOLDT (SIREN 400035903): 59 employees known on LinkedIn, none holds this role (Achat, Acheteur, Acheteuse…).",
        "messageFr": "ALTRAD ARNHOLDT (SIREN 400035903) : 59 salariés connus sur LinkedIn, aucun n'a ce rôle (Achat, Acheteur, Acheteuse…)."
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.