¿Puedo usar la API sin clave?

Sí, todos los endpoints de datos (anuncios, empresas, personas, directorio, estadísticas) están abiertos sin clave. La clave solo es necesaria para los endpoints Pro y Enterprise documentados.

¿Cómo envío mi clave API?

Cabecera X-API-Key con el valor sk_bodacc_..., o Authorization con Bearer sk_bodacc_... Una clave inválida o revocada devuelve 401.

¿Qué hago si recibo un 429?

Respete la cabecera Retry-After de la respuesta antes de reintentar. El cupo es de 60 solicitudes por minuto y por IP sin clave (600 con clave), más 10 000 solicitudes diarias sin clave (100 000 con clave).

¿Por qué la paginación está limitada?

Para evitar la descarga completa de la base: limit está limitado a 500, offset a 10 000, y el directorio a 200 páginas de 100. Itere sobre offset para recorrer los resultados.

API BODACC : autenticación y límites : BODACC.io

Acceso público gratuito

La API BODACC está abierta sin clave en todos los endpoints de datos: anuncios, empresas, personas, directorio, estadísticas. Puede consultar los datos públicos de inmediato:

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

Obtener una clave API

Las ofertas Pro y Enterprise proporcionan claves API (prefijo sk_bodacc_) desde su espacio Mi cuenta → API (/{locale}/mon-compte/api). La clave desbloquea el acceso a los endpoints documentados que la requieren.

Enviar la clave

Se aceptan dos encabezados:

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

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

Una clave inválida o revocada devuelve 401 con un cuerpo JSON explícito. La ausencia de clave deja el acceso público abierto (sin error).

Códigos de error

Código	Significado
`400`	Parámetro inválido (ej. rol de directorio desconocido)
`401`	Clave API inválida o revocada
`404`	Recurso no encontrado (anuncio, SIREN, persona)
`429`	Demasiadas solicitudes o cuota superada: respete `Retry-After`

Límites y buenas prácticas

Rate limit : 60 solicitudes/minuto por IP sin clave, 600 con una clave válida
Cuota diaria : 10 000 solicitudes/día por IP sin clave, 100 000 con clave: bloquea la iteración sistemática de filtros (descarga completa de la base); el contador se reinicia cada día
Límites anti-descarga : limit ≤ 500, offset ≤ 10 000 en anuncios/empresas/despachos; directorio y actores limitados a 200 páginas de 100
Paginación sistemática : itere sobre offset (o page/per_page para el directorio) en lugar de solicitar grandes volúmenes
Retry-After : en 429, espere la duración indicada antes de reintentar
Totales : prefiera stats/counts y stats/daily (materializados) a los COUNT(*) para los paneles de control
Datos en tiempo real : los datos se actualizan después de cada publicación del BODACC
Caché : las búsquedas habituales se sirven desde la caché perimetral de Cloudflare (300s): sus solicitudes repetidas no cuentan en la cuota

Para ir más lejos

Inicio rápido : primera llamada
Buscar anuncios : parámetros de búsqueda
Estadísticas : contadores y series

API BODACC : autenticación y límites