Como filtrar anuncios por SIREN?

Use o parâmetro siren=123456789: a API consulta o registro do anúncio via índice GIN e retorna todos os anúncios vinculados a esse SIREN, sem depender do nome do comerciante.

Qual é o limite de resultados por consulta?

limit aceita entre 1 e 500, padrão 20. A paginação para voluntariamente em 10 000 resultados acumulados (offset) para impedir o dump completo da base.

Como filtrar por família ou período?

Use família=creation, venda, modificação, radiação, coletiva, dpc... e data_inicio/data_fim no formato ISO (AAAA-MM-DD).

O que significa total_estimado?

Filtros simples (família, departamento) usam totais exatos materializados. Pesquisas de texto combinadas retornam um total estimado pelo planejador PostgreSQL, indicado por total_estimado como true.

Pesquisar anúncios BODACC : BODACC.io

Pesquisar anúncios

O endpoint GET /api/bodacc/annonces consulta o Boletim Oficial de Anúncios Civis e Comerciais: criações, vendas, modificações, radiações, procedimentos coletivos e depósitos de contas, em tempo real após cada publicação.

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

Parâmetros de pesquisa

Parâmetro	Descrição	Exemplo
`q`	Palavra-chave no comerciante ou na cidade	`q=dupont`
`typeavis`	Tipo de aviso	`typeavis=A` (criação)
`famille`	Família de anúncios	`famille=liquidation`
`departement`	Código do departamento	`departement=33`
`ville`	Cidade (insensível a acentos)	`ville=LYON`
`date_debut`	Publicação a partir de (ISO)	`date_debut=2026-07-01`
`date_fin`	Publicação até (ISO)	`date_fin=2026-07-31`
`siren`	Filtro por SIREN (registro)	`siren=123456789`
`limit`	Número de resultados (1 a 500)	`limit=50`
`offset`	Paginação (0 a 10 000)	`offset=50`

Famílias de anúncios

As famílias principais: creation, immatriculation, vente, modification, radiation, collective (procedimentos coletivos), conciliation, retablissement, dpc (depósitos de contas), divers.

# Liquidações do mês no departamento 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"

Paginação e limites

limit: entre 1 e 500 por requisição (padrão 20)
offset: até 10 000 — além disso, os resultados são truncados voluntariamente (anti-dump)
O campo total fornece o número total de resultados; total_estime: true sinaliza um total estimado pelo planejador PostgreSQL (pesquisas de texto combinadas) — filtros simples (família, departamento) usam totais exatos materializados

Ler uma resposta

Cada resultado contém: id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.

O detalhe completo de um anúncio (com as relações de empresa e pessoas) é recuperado via GET /api/bodacc/annonces/{id}:

curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"

Exemplo completo

Pesquisar as radiações de comerciantes em Bordeaux nos últimos 30 dias:

curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"

Ir mais longe

Início rápido: primeira chamada e erros
Fichas de empresas: subir do anúncio para a ficha SIREN
Autenticação e limites: chaves de API e cotas

Pesquisar anúncios BODACC