--- title: "ZumData | API de dados do CNPJ com snapshot e cobertura" description: "API em português para consultar, buscar e monitorar CNPJs a partir da base mensal da Receita Federal. Cada resposta informa o mês de origem e quanto dele está carregado." image: "https://zumdata.com/og-image.png" --- # 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. [Falar com o fundador no WhatsApp](https://wa.me/5548992091242?text=Ol%C3%A1!%20Quero%20saber%20mais%20sobre%20a%20ZumData%2C%20a%20API%20de%20dados%20do%20CNPJ.)[Ver planos](https://zumdata.com/precos/) - Acesso antecipado - Preços em reais - Fonte: dados públicos da Receita Federal O problema ## 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. Como funciona ## Da carga mensal à resposta, em quatro etapas. 1. ### 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. 2. ### Cada resposta diz de onde veio Todo `/v1` com chave válida traz `X-Snapshot-Period` e `X-Snapshot-Coverage`. `GET /v1/status` informa a origem, o período, quando foi carregado e quantas partes de cada base estão carregadas. 3. ### 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. 4. ### 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. Cobertura ## 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. O que faz ## 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](https://zumdata.com/busca-de-empresas/) ### 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](https://zumdata.com/monitoramento/) ### 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. Para quem ## 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. Preços ## 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 | [Ver a página de preços completa](https://zumdata.com/precos/) Perguntas ## 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. Acesso antecipado ## 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. [Falar com o fundador no WhatsApp](https://wa.me/5548992091242?text=Ol%C3%A1!%20Quero%20saber%20mais%20sobre%20a%20ZumData%2C%20a%20API%20de%20dados%20do%20CNPJ.)