Preciso de uma chave API?

Não, o acesso público não exige nenhuma chave. As chaves API (prefixo sk_bodacc_) são fornecidas com as ofertas Pro e Enterprise para os endpoints que exigem, em Minha conta e depois API.

Quais são os limites da API?

limit é limitado a 500 resultados por requisição e offset a 10 000. O diretório é limitado a 200 páginas de 100. Em caso de 429, respeite o cabeçalho Retry-After.

Os dados são em tempo real?

Sim, os anúncios são expostos assim que publicados no BODACC, enquanto o arquivo histórico é baixado uma vez por dia.

Início Rápido da API BODACC : BODACC.io

Q: A API BODACC é gratuita?

Sim, a API BODACC é gratuita e aberta sobre dados públicos: anúncios, empresas, pessoas, diretório e estatísticas, sem chave ou assinatura. As ofertas Pro e Enterprise adicionam chaves API e acessos prioritários.

Open data e gratuidade

A API BODACC é gratuita e aberta: ela dá acesso em open data e em tempo real à base de dados completa do Boletim Oficial — 11,3 milhões de anúncios, 6,7 milhões de empresas, 1,9 milhão de pessoas (números ao vivo em stats/counts). Enquanto o arquivo BODACC histórico é baixado uma vez por dia, a API expõe os anúncios assim que são publicados, sem chave para dados públicos.

# Os contadores exatos, sem chave
curl "https://bodacc.io/api/bodacc/stats/counts"

Primeira chamada

A API pública BODACC é acessível sem chave para os dados. O endpoint mais utilizado pesquisa anúncios por palavra-chave:

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

Resposta (trecho):

{
  "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
}

Especificação completa

A API documenta 46 endpoints (verificado na OpenAPI ao vivo). Duas formas de explorá-los:

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

Endpoints principais

Endpoint	Descrição
`GET /api/bodacc/annonces`	Pesquisa de anúncios (palavra-chave, família, cidade, departamento, SIREN, datas)
`GET /api/bodacc/annonces/{id}`	Detalhe de um anúncio + relações (empresa, pessoas)
`GET /api/bodacc/entreprises`	Pesquisa de empresas (nome, SIREN, NAF, estado, filtros enriquecidos)
`GET /api/bodacc/entreprises/{siren}`	Ficha completa de um SIREN
`GET /api/bodacc/personnes/{id}`	Ficha de pessoa (identidade + mandatos)
`GET /api/bodacc/annuaire/{role}`	Diretório de liquidantes, mandatários, administradores
`GET /api/bodacc/stats/counts`	Contadores globais (anúncios, empresas, pessoas)

Autenticação

O acesso público não exige nenhuma chave. Para as ofertas Pro e Enterprise, os endpoints documentados aceitam uma chave de API:

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

A chave também pode ser enviada como Authorization: Bearer sk_bodacc_.... Uma chave inválida ou revogada retorna 401.

Erros

A API retorna erros HTTP padrão com um corpo JSON detalhando o problema:

400: parâmetro inválido
401: chave de API inválida ou revogada
404: recurso não encontrado
429: muitas requisições — respeite o cabeçalho Retry-After

Limites

limit: entre 1 e 500 por requisição
offset: até 10 000 (paginação anti-dump)
Os dados são atualizados em tempo real após cada publicação do BODACC
A pesquisa por família usa totais exatos materializados (total_estime ausente); pesquisas de texto combinadas podem retornar um total estimado ("total_estime": true)

Aprofundar

Pesquisar anúncios: todos os parâmetros de pesquisa
Fichas de empresas: pesquisa e ficha SIREN
Pessoas e diretório: dirigentes e profissionais
Estatísticas: contadores e séries
Autenticação e limites: chaves de API e boas práticas

Início Rápido da API BODACC