¿Se necesita una clave API?

No, el acceso público no requiere ninguna clave. Las claves API (prefijo sk_bodacc_) se proporcionan con las ofertas Pro y Enterprise para los endpoints que lo exigen, desde Mi cuenta y luego API.

¿Cuáles son los límites de la API?

limit está limitado a 500 resultados por solicitud y offset a 10 000. El directorio está limitado a 200 páginas de 100. En caso de 429, respete la cabecera Retry-After.

¿Los datos están en tiempo real?

Sí, los anuncios se exponen desde su publicación en el BODACC, mientras que el archivo histórico se descarga una vez al día.

Inicio rápido API BODACC : BODACC.io

Q: ¿La API BODACC es gratuita?

Sí, la API BODACC es gratuita y abierta sobre datos públicos: anuncios, empresas, personas, directorio y estadísticas, sin clave ni suscripción. Las ofertas Pro y Enterprise añaden claves API y accesos prioritarios.

Open data y gratuidad

La API BODACC es gratuita y abierta: ofrece acceso en open data y en tiempo real a la base de datos completa del Boletín Oficial — 11,3 millones de anuncios, 6,7 millones de empresas, 1,9 millones de personas (cifras en vivo stats/counts). Mientras que el archivo BODACC histórico se descarga una vez al día, la API expone los anuncios desde su publicación, sin clave para los datos públicos.

# Los contadores exactos, sin clave
curl "https://bodacc.io/api/bodacc/stats/counts"

Primera llamada

La API pública BODACC es accesible sin clave para los datos. El endpoint más utilizado busca anuncios por palabra clave:

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

Respuesta (extracto):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

Especificación completa

La API documenta 46 endpoints (verificado en el OpenAPI en vivo). Dos formas de explorarlos:

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

Endpoints principales

Endpoint	Descripción
`GET /api/bodacc/annonces`	Búsqueda de anuncios (palabra clave, familia, ciudad, departamento, SIREN, fechas)
`GET /api/bodacc/annonces/{id}`	Detalle de un anuncio + relaciones (empresa, personas)
`GET /api/bodacc/entreprises`	Búsqueda de empresas (nombre, SIREN, NAF, estado, filtros enriquecidos)
`GET /api/bodacc/entreprises/{siren}`	Ficha completa de un SIREN
`GET /api/bodacc/personnes/{id}`	Ficha de persona (identidad + mandatos)
`GET /api/bodacc/annuaire/{role}`	Directorio de liquidadores, mandatarios, administradores
`GET /api/bodacc/stats/counts`	Contadores globales (anuncios, empresas, personas)

Autenticación

El acceso público no requiere ninguna clave. Para las ofertas Pro y Enterprise, los endpoints documentados aceptan una clave API:

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

La clave también se puede pasar como Authorization: Bearer sk_bodacc_.... Una clave inválida o revocada devuelve 401.

Errores

La API devuelve errores HTTP estándar con un cuerpo JSON que detalla el problema:

400: parámetro inválido
401: clave API inválida o revocada
404: recurso no encontrado
429: demasiadas solicitudes — respete el encabezado Retry-After

Límites

limit: entre 1 y 500 por solicitud
offset: hasta 10 000 (paginación anti-descarga)
Los datos se actualizan en tiempo real después de cada publicación del BODACC
La búsqueda por familia utiliza totales exactos materializados (total_estime ausente); las búsquedas de texto combinadas pueden devolver un total estimado ("total_estime": true)

Para profundizar

Buscar anuncios: todos los parámetros de búsqueda
Fichas de empresas: búsqueda y ficha SIREN
Personas y directorio: directivos y profesionales
Estadísticas: contadores y series
Autenticación y límites: claves API y buenas prácticas

Inicio rápido API BODACC