Dados do CNPJ por API, com o mês e a cobertura de cada resposta.
A base mensal da Receita Federal, carregada, indexada e servida em JSON: consulta por CNPJ, busca por CNAE, UF e porte, monitoramento com webhook e enriquecimento em lote.
- Acesso antecipado
- Preços em reais
- Fonte: dados públicos da Receita Federal
A fonte é pública e gratuita. Operá‑la é que dá trabalho.
Quem precisa de dados de empresas dentro de um produto acaba escrevendo um carregador e cuidando dele todo mês.
A Receita Federal publica o cadastro de CNPJ em arquivos zip divididos em dez partes, em CSV com codificação Latin-1 e sem cabeçalho. A cada mês o conjunto é substituído por inteiro, e o endereço do compartilhamento já mudou de lugar mais de uma vez.
Uma fintech que valida um lojista no cadastro, um marketplace que preenche o formulário a partir do CNPJ, uma área de crédito que quer saber quando um devedor é baixado: todos precisam da mesma coisa, e nenhum deles quer manter o carregador.
A ZumData faz esse trabalho uma vez e entrega o resultado como chamadas HTTP.
Da carga mensal à resposta, em quatro etapas.
Carga mensal sem meio-termo
Um fluxo Temporal lista os arquivos da Receita, baixa cada um com requisições de faixa retomáveis, lê o zip em fluxo, converte de Latin-1 e copia para tabelas de preparo. Só depois troca as tabelas em uma única transação. A API nunca lê uma tabela de preparo.
Cada resposta diz de onde veio
Todo
/v1com chave válida trazX-Snapshot-PeriodeX-Snapshot-Coverage.GET /v1/statusinforma a origem, o período, quando foi carregado e quantas partes de cada base estão carregadas.Consulta, busca e sócios
Um CNPJ volta como um único documento JSON, com CNAE, município, natureza jurídica, qualificação e motivo já traduzidos. A busca filtra por UF, município, CNAE, situação, porte, abertura e capital.
Monitoramento e lote
Depois de cada carga, a ZumData compara os CNPJs monitorados e envia o que mudou ao seu webhook. Para listas grandes, o lote processa os CNPJs em um job em vez de milhares de chamadas.
Registro carregado em parte nunca é servido como se fosse inteiro.
Se o mês está carregado só em parte, a resposta traz not_held com o que falta. Um CNPJ que a ZumData não tem recebe not_in_snapshot, e não not_found: a API não diz que uma empresa não existe a partir de um registro que não carregou por completo.
Respostas not_in_snapshot não entram na cota nem na fatura. A unidade medida é a resposta dada, não a requisição feita.
Rotas que existem hoje no código.
Consulta por CNPJ
GET /v1/cnpj/{cnpj} devolve estabelecimento, empresa, sócios e Simples/MEI. Há também rotas só de sócios e só de estabelecimentos da mesma empresa.
Busca de estabelecimentos
GET /v1/cnpj/search com paginação por cursor e até 100 resultados por página, a partir do plano Dev. Detalhes
Sócios sem desmascarar
O CPF dos sócios chega mascarado na fonte e é servido como chega. A ZumData não desmascara, não cruza e não infere CPF.
Monitoramento com webhook
Corpo assinado com HMAC-SHA256, nova tentativa quando a entrega falha, e cada mudança com valor antes e depois. Detalhes
Enriquecimento em lote
POST /v1/batch aceita JSON ou CSV com um CNPJ por linha. O resultado volta em linhas JSON, cada uma com o seu not_held.
Tabelas de referência
CNAE, município, natureza jurídica, qualificação, motivo e país em /v1/reference, sem consumir a cota.
Além do CNPJ, o código já tem rotas para Tesouro Direto e séries do Banco Central. O CNPJ é o produto principal e é o que esta página descreve.
Quem precisa de dados de empresa dentro do próprio produto.
- Fintechs e facilitadores de pagamento: o CNPJ existe, está ativo, bate com o nome e o endereço declarados, e quem são os sócios.
- Marketplaces e SaaS: preenchimento e validação de um campo de CNPJ no cadastro.
- Análise de mercado B2B: empresas ativas em um CNAE e uma UF, abertas em um período.
- Crédito e cobrança: aviso quando a situação de um devedor muda ou um sócio sai.
- Contabilidade e ERP: enriquecimento em lote da carteira de clientes.
Cinco planos, em reais.
Excedente nos planos pagos: R$ 1 por mil requisições. A cobrança ainda não está ativa, e o acesso hoje é combinado por conversa.
| Plano | Preço | Requisições | Por minuto | Rotas de CNPJ | Monitoramento | Lote |
|---|---|---|---|---|---|---|
| Free | R$ 0 | 300 por dia | 5 | Consulta por CNPJ | não | não |
| Dev | R$ 49 por mês | 20.000 por mês | 60 | Consulta e busca | não | não |
| Pro | R$ 199 por mês | 150.000 por mês | 300 | Consulta, busca e busca de sócios | 500 CNPJs | até 50.000 linhas por lote |
| Scale | R$ 699 por mês | 1.000.000 por mês | 1.000 | Consulta, busca e busca de sócios | 10.000 CNPJs | até 1.000.000 de linhas por lote |
| Enterprise | sob consulta | sem cota fixa, medido para a fatura | limite dedicado | Tudo do Scale | limite dedicado | limite dedicado |
O que costumam perguntar.
Posso me cadastrar e usar hoje?
Ainda não. A API não está aberta ao público. Para testar, fale com o fundador pelo WhatsApp e combinamos o acesso.
A ZumData tem o cadastro inteiro carregado?
A resposta a essa pergunta está em cada chamada: GET /v1/status informa a origem, o período e quantas partes de cada base estão carregadas. Quando o mês está em parte, a API diz isso em vez de esconder.
De onde vêm os dados?
Do conjunto de dados abertos de CNPJ da Receita Federal, publicado todo mês. A ZumData não altera os valores: ela os carrega, indexa e resolve os códigos para descrições.
Vocês mostram o CPF dos sócios?
Não. O CPF vem mascarado da fonte e é servido mascarado. A ZumData não desmascara, não cruza e não infere CPF.
Como o excedente é medido?
Por resposta dada. Um CNPJ que a ZumData não tem carregado volta como not_in_snapshot e não é contado nem cobrado.
Posso montar uma lista de contatos de pessoas físicas?
Não. Os termos de uso minutados proíbem usar os dados para formar listas de contato de pessoas físicas. O uso previsto é a validação e a análise de empresas.
Converse com quem constrói a ZumData.
A API ainda não está aberta ao público. Para testar com os seus CNPJs, o caminho é uma conversa direta com o fundador.