Quickstart

First call

The public BODACC API is accessible without a key for data:

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

Specification

The full specification (32 endpoints) is available in OpenAPI format:

  • Swagger UI: https://bodacc.io/api/bodacc/docs
  • https://bodacc.io/api/bodacc/openapi.json

Authentication

Documented endpoints may require an API key (Pro and Enterprise plans). Without a key, access to public data remains open.

Errors

The API returns standard HTTP errors (400, 404, 429) with a JSON body describing the issue. On 429, respect the Retry-After header.