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 liberar a exportação.
-
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
Limites 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 listagens Consulta 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 filtros A consulta mais cara: filtra a base inteira | 30/min · 300/h | 60/min · 600/h | 120/min · 1.200/h |
| Catálogos e territórios CNAEs, 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ção Dispara um processamento em fila | Indisponível | 5/h · 20/dia | 5/h · 20/dia |
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; o estado de cada item fica no roadmap.
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.