API para desenvolvedores
Os mesmos dados do site, em JSON. A leitura é pública: dá para começar agora, sem cadastro e sem chave.
O que dá para fazer
Consultar uma empresa
Dados cadastrais completos a partir do CNPJ, numa requisição.
Filtrar a base
Recortes por atividade econômica, porte, situação cadastral e localidade.
Ler o quadro societário
Sócios, qualificação e os estabelecimentos de uma mesma raiz de CNPJ.
Obter dados territoriais
Municípios, estados e regiões, com estatísticas agregadas.
Usar os catálogos
Tabelas de CNAE, natureza jurídica e qualificação de sócio, prontas para preencher seletores.
Exportar um recorte
Exportação assíncrona de um conjunto grande de resultados. Requer token.
Principais endpoints
A lista completa, com todos os parâmetros e exemplos de resposta, está na documentação interativa.
Os endpoints territoriais respondem um conjunto mínimo de campos. Use ?fields= para pedir os demais — por exemplo ?fields=ibge_code,name,statistics.
Autenticação
A leitura é anônima e não exige nada. O token serve para duas coisas: subir os limites de uso e disparar a exportação por aqui. Ele identifica quem chama — não é cobrança, e não destranca endpoint nenhum que já não esteja aberto.
- Token no cabeçalho
Authorization: Bearer - Tokens gerados e revogados no painel da conta
- Escopo de permissão por token
Formatos e respostas
- Respostas em JSON
- Paginação por cursor, para percorrer conjuntos grandes
- Filtros por parâmetro de consulta
- Seleção de campos com
?fields= - Cabeçalhos
X-RateLimit-*em toda resposta
Use os dados no seu assistente de IA
Com o MCP do Base Empresarial, Claude Code, Codex e outros clientes compatíveis podem consultar empresas e usar suas buscas salvas durante a conversa. A conexão exige uma conta com e-mail verificado e sua autorização pelo navegador.
Saiba como conectar pelo MCPLimites de uso
Existem para impedir que um uso automatizado derrube o serviço para todo mundo. Não são um paywall disfarçado.
| Superfície | Sem identificação | Com conta | Com token |
|---|---|---|---|
| Leituras e listagensConsulta por CNPJ, listagens de empresas, estabelecimentos e sócios | 60/min · 600/h | 120/min · 1.500/h | 240/min · 3.000/h |
| Busca com filtrosA consulta mais cara: filtra a base inteira | 30/min · 300/h | 60/min · 600/h | 120/min · 1.200/h |
| Catálogos e territóriosCNAEs, naturezas jurídicas, localidades e estatísticas, servidos de cache. É também o teto que vale para toda a API | 300/min · 3.000/h | 600/min · 6.000/h | 600/min · 6.000/h |
| ExportaçãoDispara um processamento em fila | Indisponível | 5/h · 20/dia | 5/h · 20/dia |
| Formulário de contatoEnvio do formulário público: dispara e-mail de confirmação e notificação interna | 2/min · 5/h | 3/min · 10/h | 3/min · 10/h |
| Pedido de titular de dadosCanal do titular, com contagem separada da do formulário geral: um pico comercial não consome a cota de quem exerce um direito com prazo | 2/min · 5/h | 3/min · 10/h | 3/min · 10/h |
| Interpretação em linguagem naturalA única superfície pública cujo custo é dinheiro por requisição | 5/min · 40/h | 15/min · 150/h | 15/min · 150/h |
As janelas são cumulativas: vale sempre a mais restritiva que se aplica. Ao estourar um limite, a resposta é 429 com o cabeçalho Retry-After indicando em quantos segundos tentar de novo. Cada página de resultados aceita no máximo 100 itens.
O que é gratuito e o que será Premium
Gratuito, hoje
Toda a leitura: empresas, estabelecimentos, sócios, catálogos e dados territoriais. Sem cadastro, sem chave e com a documentação aberta. Isso é dado público, e continua aberto.
Premium, planejado
Limites bem maiores, exportação programática em escala, webhooks e SDKs. São os usos cujo custo cresce junto com o volume. Nada disso está disponível ainda.
Quem usa e para quê
Conferência cadastral
Verificar CNPJ e situação cadastral no momento em que alguém preenche um formulário, em vez de descobrir depois.
Pesquisa e estudos
Montar recortes por setor, território e período sem baixar e processar os arquivos da Receita Federal.
Jornalismo de dados
Cruzar empresas, sócios e atividades para apuração, com fonte pública e rastreável.
Aplicações e painéis
Alimentar um sistema próprio ou um painel de BI com dados cadastrais atualizados a cada carga.
Comece pela documentação
A primeira requisição não exige cadastro nem chave. Crie uma conta só quando precisar de limites maiores ou de exportação.