Basile

Basile Personnes API

Recherche et export de contacts (dirigeants légaux + profils LinkedIn).

GitHub OpenAPI

Operations 4

POST /people/find Rechercher des personnes #
POST /people/export Exporter des personnes (CSV) #
GET /people/{id} Fiche brute d'une personne #
GET /people/{id}/full Fiche complète d'une personne #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/basile-cc/openapi/basile-cc-personnes-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/basile-cc:basile-cc-personnes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

basile-cc-personnes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Basile Personnes API
  version: 1.0.0
  description: '**Basile** est une base de données B2B française : ~26,8 M sociétés et ~29,5 M

    contacts, issus du croisement de trois sources :

    - **Legal** — registre légal français (INSEE / INPI-RNE) : dirigeants, SIREN, NAF, forme juridique…

    - **LKI** — profils LinkedIn : intitulé de poste, séniorité, compétences, écoles…

    - **GMB** — Google My Business : note, avis, horaires, catégorie…


    L''API expose deux recherches symétriques — **personnes** (`/people`) et

    **entreprises** (`/companies`) — avec un système de filtres `include`/`exclude`,

    un comptage gratuit avant extraction, et un export CSV enrichi.


    ### Authentification

    Toutes les requêtes portent la clé API dans le header `Authorization`, **en clair,

    sans préfixe `Bearer`** : `Authorization: REDACTED_STRIPE_KEY`.


    ### `find` vs `export` : ce que chacun renvoie

    Les deux acceptent exactement les mêmes `filters`. La différence est la **richesse des données**.


    - **`/people/find` renvoie la personne, PAS sa société.** Identité, localisation, poste,

    URL LinkedIn, plus le **nom** et l''**identifiant interne** de son employeur — mais **aucune**

    donnée de cette société : ni SIREN/NAF/forme juridique, ni effectif/secteur/description,

    ni note/avis/adresse Google.

    - **`/people/export` renvoie la ligne complète : 92 colonnes** — 22 sur la personne,

    **18 sur sa société LinkedIn**, **31 sur sa société au registre légal**, **11 Google Maps**,

    6 drapeaux de présence. Pour UNE fiche, `GET /people/{id}/full` rend le même modèle sans

    passer par un export.

    - **`/companies/find` croise DÉJÀ les trois sources** : chaque résultat porte sa fiche et,

    quand la correspondance existe, celles des deux autres sources sous `x_legal` / `x_lki` /

    `x_gmb`. Contrairement aux personnes, inutile d''exporter pour voir les trois sources.

    - **`/companies/export` renvoie 70 colonnes** : les mêmes données mises à plat en CSV.


    Règle pratique : pour des contacts avec le contexte de leur entreprise, `/find` sert à cibler

    et à compter, puis **c''est `/export` qui produit la donnée exploitable**.


    ### Facturation

    **Compter est gratuit, sans limite.** Envoyez `{ "countOnly": true }` (ou `limit: 0`) :

    la réponse contient `total` et un tableau `leads` vide, et **rien n''est débité**.


    **Récupérer des enregistrements coûte 1 crédit par enregistrement renvoyé** — sur `/find`

    (hors mode count-only), sur `/people/{id}` et `/companies/{id}`, et sur `/export`. Le débit

    a lieu **à chaque appel** : redemander les mêmes enregistrements est **re-facturé** (la

    donnée a pu être rafraîchie depuis ; il n''existe pas de registre « déjà payé »).


    ⚠️ `limit: 1` n''est **pas** un mode de comptage : il renvoie 1 enregistrement, donc

    1 crédit. Pour compter, utilisez `countOnly: true`.


    Quota épuisé → **402** `quota_exhausted`, renvoyé **avant** les enregistrements : rien

    n''est livré et rien n''est débité.


    Règle d''or : **comptez d''abord** avec `countOnly`, puis n''extrayez que les enregistrements

    dont vous avez besoin.'
  contact:
    name: Support Basile
    url: https://basile.cc
    email: contact@basile.cc
servers:
- url: https://api.basile.cc
  description: Production
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (58 KB total) ---
# Full source: https://artifacts.apis.io/basile-cc/openapi/basile-cc-personnes-api-openapi.yml