Puis-je utiliser l'API sans clé ?

Oui, tous les endpoints de données (annonces, entreprises, personnes, annuaire, statistiques) sont ouverts sans clé. La clé n'est requise que pour les endpoints Pro et Enterprise documentés.

Comment passer ma clé API ?

En-tête X-API-Key avec la valeur sk_bodacc_..., ou Authorization avec Bearer sk_bodacc_... Une clé invalide ou révoquée renvoie 401.

Que faire en cas de 429 ?

Respectez l'en-tête Retry-After de la réponse avant de réessayer. Le quota est de 60 requêtes par minute et par IP sans clé (600 avec clé), plus 10 000 requêtes par jour sans clé (100 000 avec clé).

Pourquoi la pagination est-elle bornée ?

Pour empêcher le dump complet de la base : limit est plafonné à 500, offset à 10 000, et l'annuaire à 200 pages de 100. Itérez sur offset pour parcourir les résultats.

API BODACC : authentification et limites : BODACC.io

Accès public gratuit

L'API BODACC est ouverte sans clé sur tous les endpoints de données : annonces, entreprises, personnes, annuaire, statistiques. Vous pouvez interroger les données publiques immédiatement :

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

Obtenir une clé API

Les offres Pro et Enterprise fournissent des clés API (préfixe sk_bodacc_) depuis votre espace Mon compte → API (/{locale}/mon-compte/api). La clé débloque l'accès aux endpoints documentés qui l'exigent.

Passer la clé

Deux en-têtes acceptés :

# En-tête X-API-Key
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

# Ou Authorization Bearer
curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "Authorization: Bearer sk_bodacc_..."

Une clé invalide ou révoquée renvoie 401 avec un corps JSON explicite. L'absence de clé laisse l'accès public ouvert (aucune erreur).

Codes d'erreur

Code	Signification
`400`	Paramètre invalide (ex. rôle d'annuaire inconnu)
`401`	Clé API invalide ou révoquée
`404`	Ressource introuvable (annonce, SIREN, personne)
`429`	Trop de requêtes ou quota dépassé — respectez `Retry-After`

Limites et bonnes pratiques

Rate limit : 60 requêtes/minute par IP sans clé, 600 avec une clé valide
Quota journalier : 10 000 requêtes/jour par IP sans clé, 100 000 avec clé — il bloque l'itération systématique des filtres (dump complet de la base) ; le compteur se réinitialise chaque jour
Bornes anti-dump : limit ≤ 500, offset ≤ 10 000 sur annonces/entreprises/cabinets ; annuaire et acteurs bornés à 200 pages de 100
Pagination systématique : itérez sur offset (ou page/per_page pour l'annuaire) au lieu de demander de gros volumes
Retry-After : sur 429, attendez la durée indiquée avant de réessayer
Totaux : préférez stats/counts et stats/daily (matérialisés) aux COUNT(*) pour les tableaux de bord
Données temps réel : les données sont rafraîchies après chaque parution du BODACC
Cache : les recherches courantes sont servies par le cache edge Cloudflare (300s) — vos requêtes répétées ne comptent pas dans le quota

Aller plus loin

Démarrage rapide : premier appel
Rechercher des annonces : paramètres de recherche
Statistiques : compteurs et séries

API BODACC : authentification et limites