GET v1/empresas?q=
Busca por razão social ou prefixo de CNPJ. Até 20 resultados com slug e link.
api pública · beta
Os balanços do Brasil, direto no seu código.
Uma API REST em JSON pra buscar empresas, ler balanços, DREs, publicações e rankings — de uma planilha, um ETL ou o produto que você está construindo. Autentica por chave, responde em segundos, sem contrato pra assinar.
- 29.677
- empresas na base
- REST · JSON
- sem SDK obrigatório
- 60 / min
- chamadas por conta
- grátis
- beta aberto
uma chamada real
GET /v1/empresas?q=petrobras
Troque bal_live_SEU_TOKEN pela chave que você cria em Minha conta. A resposta vem no envelope padrão do contrato — veja o formato completo no guia.
curl "https://api.balancos.ai/v1/empresas?q=petrobras" \
-H "Authorization: Bearer bal_live_SEU_TOKEN"os recursos
Seis rotas, o dataset inteiro
Cada rota tem o exemplo de resposta completo no guia, com cada campo explicado.
GET v1/empresas/{chave}
Ficha cadastral: CNAE, natureza jurídica, situação, capital, UF/município, setor.
GET v1/empresas/{chave}/balancos
Balanços patrimoniais em reais, um item por exercício, com fonte (LLM ou XBRL) e escala declarada.
GET v1/empresas/{chave}/dres
Demonstrações de resultado (DRE) por exercício, mesmo formato dos balanços.
GET v1/empresas/{chave}/documentos
Índice de publicações legais, mais recentes primeiro. Até 100 por chamada.
GET v1/ranking
Maiores ou que mais crescem, por ativo, receita, lucro ou crescimento — com filtros de UF e setor.
plano gratuito
Um plano só, pensado pra validar seu uso
Grátis, sem cartão
Um plano único: 60 chamadas por minuto por conta e até 5 chaves ativas. Sem cota mensal.
Toda chamada admitida conta
Mesmo terminando em 404 ou erro. Chave inválida, o piso por IP e /docs não contam.
Contrato estável
Campos não somem nem trocam de tipo dentro do v1 — mudança incompatível é sempre /v2.
Fontes oficiais
Mesma base do site e do MCP: diários oficiais, jornais e portais de RI, com link do original.
Cobrança e planos pagos ainda não existem — quando existirem, o plano gratuito continua. Detalhes de contagem e os headers de limite estão no guia, seção Limites.
Crie sua chave e faça a primeira chamada
Grátis, sem cartão de crédito. Prefere um assistente de IA em vez de código? Veja o servidor MCP.
Ir para Minha conta