# Basile API

> Base de données B2B française : ~26 M sociétés (registre légal + LinkedIn + Google My Business)
> et ~4,4 M contacts (dirigeants légaux + profils LinkedIn). API REST sur https://api.basile.cc.
> Auth : header `Authorization` avec la clé API brute (PAS de préfixe `Bearer`), `Content-Type: application/json`.

## Ressources machine-readable
- [Spécification OpenAPI (YAML)](/openapi.yaml) : tous les endpoints, filtres, schémas de requête/réponse.
- [Skill Claude (ZIP)](/basile-skill.zip) : skill prête à l'emploi (recherche, comptage, export, enrichissement).
- [Référence skill (JSON)](/skill-reference.json) : métadonnées de la skill.

## Endpoints clés
- `POST /people/find` — chercher des personnes (body `{ filters, limit, paginationToken }`). `limit:1` pour compter (champ `total`).
- `POST /companies/find` — chercher des entreprises. Renvoie `total` (sociétés dédupliquées) et `establishmentsTotal` (points de vente / fiches Google).
- `POST /people/export` · `POST /companies/export` — export CSV (companies : param `mode` = `"companies"` | `"locations"`). Consomme du quota.
- `GET /companies/activity-suggest?q=` — IDs de concept unifiés pour le filtre `activity` (métier/secteur, people ET companies).
- `GET /people/:id/full` · `GET /companies/:id/full` — fiche complète (toutes colonnes).

## Notes de filtrage
- Filtre texte = `{ "include": [...], "exclude": [...] }` (include = OR, exclude = NOT) ; plusieurs filtres = ET.
- `activity` fonctionne directement sur `/people/find` (secteur de l'entreprise de la personne).
- France : `result_country_code` (people) / `headquarters_country_code` (companies) = `{ "include": ["FR"] }`.