Posso usar a API sem chave?

Sim, todos os endpoints de dados (anúncios, empresas, pessoas, diretório, estatísticas) estão abertos sem chave. A chave é necessária apenas para os endpoints Pro e Enterprise documentados.

Como enviar minha chave de API?

Use o cabeçalho X-API-Key com o valor sk_bodacc_..., ou Authorization com Bearer sk_bodacc_... Uma chave inválida ou revogada retorna 401.

O que fazer em caso de erro 429?

Respeite o cabeçalho Retry-After da resposta antes de tentar novamente. O limite é de 60 requisições por minuto por IP sem chave (600 com chave), além de 10 000 requisições por dia sem chave (100 000 com chave).

Por que a paginação é limitada?

Para evitar o download completo da base: limit é limitado a 500, offset a 10 000, e o diretório a 200 páginas de 100. Itere sobre o offset para percorrer os resultados.

API BODACC : autenticação e limites : BODACC.io

Acesso público gratuito

A API BODACC é aberta sem chave em todos os endpoints de dados: anúncios, empresas, pessoas, diretório, estatísticas. Você pode consultar os dados públicos imediatamente:

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

Obter uma chave API

As ofertas Pro e Enterprise fornecem chaves API (prefixo sk_bodacc_) a partir do seu espaço Minha conta → API (/{locale}/mon-compte/api). A chave desbloqueia o acesso aos endpoints documentados que a exigem.

Enviar a chave

Dois cabeçalhos aceitos:

# Cabeçalho 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_..."

Uma chave inválida ou revogada retorna 401 com um corpo JSON explícito. A ausência de chave mantém o acesso público aberto (nenhum erro).

Códigos de erro

Código	Significado
`400`	Parâmetro inválido (ex.: papel de diretório desconhecido)
`401`	Chave API inválida ou revogada
`404`	Recurso não encontrado (anúncio, SIREN, pessoa)
`429`	Muitas requisições ou cota excedida — respeite `Retry-After`

Limites e boas práticas

Rate limit : 60 requisições/minuto por IP sem chave, 600 com uma chave válida
Cota diária : 10 000 requisições/dia por IP sem chave, 100 000 com chave — ela bloqueia a iteração sistemática dos filtros (dump completo da base); o contador é redefinido a cada dia
Limites anti-dump : limit ≤ 500, offset ≤ 10 000 em anúncios/empresas/escritórios; diretório e atores limitados a 200 páginas de 100
Paginação sistemática : itere sobre offset (ou page/per_page para o diretório) em vez de solicitar grandes volumes
Retry-After : em 429, aguarde a duração indicada antes de tentar novamente
Totais : prefira stats/counts e stats/daily (materializados) em vez de COUNT(*) para painéis de controle
Dados em tempo real : os dados são atualizados após cada publicação do BODACC
Cache : as buscas comuns são servidas pelo cache edge da Cloudflare (300s) — suas requisições repetidas não contam para a cota

Ir mais longe

Início rápido : primeira chamada
Pesquisar anúncios : parâmetros de pesquisa
Estatísticas : contadores e séries

API BODACC : autenticação e limites