Tecnologia

API de CNPJ sem banco de dados no caminho: como ela responde?

A API de CNPJ lê a base da Receita direto de arquivos jsonW, sem servidor de banco no caminho. Medidas publicadas, uma chamada real e os limites.

Por Equipe Wortic 7 min de leitura

A API de CNPJ da Wortic responde sem um servidor de banco de dados no caminho entre o pedido e a resposta. Segundo o guia da própria API, o servidor abre os arquivos jsonW da base uma vez e responde lendo direto deles. A página para desenvolvedores diz o mesmo sobre a API de CNPJ e a de CEP. Neste texto, explico o que essa arquitetura promete, quais números a Wortic publica, como fazer uma chamada real e o que a documentação não mostra.

O que significa responder sem banco no caminho?

Num sistema comum, uma consulta de CNPJ passa por um banco relacional ou por um índice separado. O pedido chega ao servidor, o servidor consulta o banco, e a resposta volta com o resultado. Cada etapa tem custo, e o banco pede manutenção, memória e cópias de segurança. O guia da API de CNPJ descreve outro caminho: os dados da Receita ficam em arquivos jsonW, e o servidor lê esses arquivos sem um servidor de banco no meio.

O guia não entra no detalhe de como a busca funciona por dentro. O código do servidor não é público, e eu não o li. Por isso, este texto afirma apenas o que o guia diz e o que a chamada pública mostra. Para quem consome a API, a diferença aparece pouco. Você continua fazendo o pedido, recebendo a ficha e respeitando o limite de consultas. A mudança fica do lado de dentro da Wortic.

Quais números a Wortic publica?

O guia traz medidas feitas no servidor, sem contar a rede. Montar uma ficha leva 0,24 ms na mediana, com 200 CNPJs distintos, medidos em 14/11/2026. Uma busca por nome leva 0,20 ms na mediana, com 10 termos, na mesma data. A primeira leitura de uma região do arquivo chega a até 23,8 ms para 95% das fichas. A base tem 73.809.379 estabelecimentos. O próprio guia avisa que o tempo que você vê no seu sistema soma a rede até o servidor, e que os números são só a parte do servidor.

O guia também cita dois números sobre o formato. O mesmo dado ficou 6,6 vezes menor que em JSONL sem compressão, num teste com 100 mil registros, medido com a versão 1.3.11 em 13/11/2026. Na base de marcas do INPI, com 55,3 milhões de linhas, o arquivo jsonW ficou 4,9 vezes menor que o CSV. O guia não informa a versão dessa segunda medida, então trate os dois números como sinal, e leia o método completo no paper do jsonW.

Esses números são da Wortic, e eu não os reproduzi. Quem quer conferir a latência precisa medir do seu lado, com a sua rede, porque o tempo final depende da distância até o servidor e da carga do momento.

Como fazer uma chamada real?

A chamada abaixo busca a ficha da própria Wortic, pelo CNPJ 37.853.407/0001-71. Ela não pede chave. Rodei o comando em 15/11/2026, às 12h09 UTC. Os cabeçalhos mostram o mês da base e o limite diário, e o número de consultas restantes cai a cada chamada.

$ curl -s -D - -o /dev/null https://cnpj.wortic.com/cnpj/37853407000171
HTTP/2 200
content-type: application/json
x-base-cnpj: 2026-10
x-ratelimit-limit-dia: 2000
x-ratelimit-restante-dia: 1982

O corpo da resposta vem em JSON. O começo dele, com o mesmo CNPJ, fica assim:

$ curl -s https://cnpj.wortic.com/cnpj/37853407000171
{"cnpj":"37853407000171","cnpj_formatado":"37.853.407/0001-71","razao_social":"WORTIC LTDA","nome_fantasia":"","tipo":{"codigo":1,"descricao":"Matriz"},"situacao":{"codigo":2,"descricao":"Ativa","desde":"2020-07-24"},"abertura":"2020-07-24"...}

Um CNPJ com dígitos verificadores errados também é recusado, com 400. Esta é a resposta real a um número inventado:

$ curl -s -i https://cnpj.wortic.com/cnpj/12345678000100
HTTP/2 400
{"erro":{"codigo":"cnpj_invalido","mensagem":"CNPJ invalido (confira os digitos)."}}

O guia de validação do CNPJ recomenda conferir os dígitos no seu sistema antes de consultar, e isso vale também para o CNPJ alfanumérico. Quem confere antes evita a chamada inútil, e não gasta consulta com um número que nem pode existir.

Quando a resposta sem banco ajuda e quando não ajuda?

A arquitetura ajuda quando você consulta muitas fichas pelo CNPJ e precisa de resposta curta, sem manter um banco próprio para a base da Receita. O guia diz também que, se você guarda as fichas para consultar depois, guardar em jsonW deixa a busca rápida sem subir um banco. Isso vale para um arquivo do seu próprio sistema, e não para a API.

Não ajuda quando a pergunta não está na base. O llms.txt da API avisa que a base não traz faturamento, número de funcionários nem dívidas. Quem precisa desses dados deve buscar outra fonte, e não deduzir os números a partir da ficha.

Também não ajuda quem quer baixar a base inteira com um laço de chamadas. O limite grátis é de 60 consultas por minuto e 2.000 por dia, por IP. Acima disso, a resposta é 402 com o código limite_gratis. Para volume, a documentação aponta a chave do plano, e os planos da Wortic ficam na página de planos.

O que a documentação não cobre?

O guia não diz com que frequência a base é atualizada. O llms.txt diz que o mês da base vem no cabeçalho x-base-cnpj, no formato AAAA-MM, e a chamada que fiz mostrou 2026-10. Quem precisa de um dado do mês corrente deve olhar esse cabeçalho antes de afirmar que a informação é recente.

O guia também não descreve como os arquivos são gerados a partir do arquivo mensal da Receita. Como o código do servidor não é público, o texto não afirma detalhes que não pude conferir. O que dá para conferir de fora é a resposta da API, o cabeçalho com o mês da base e os códigos de erro.

Por fim, este guia não diz quanto tempo uma ficha pode ficar guardada no seu sistema. Esse cuidado está em outro guia da própria API, sobre o cache do lado do cliente, que vale ler antes de montar um cache próprio.

Onde a Wortic entra?

A Wortic publica a API de CNPJ e mantém o formato jsonW, que tem o código público no GitHub. Quem desenvolve encontra a página para desenvolvedores, com as APIs abertas de CNPJ e CEP. Quem precisa de volume maior confere os planos da Wortic.

Perguntas frequentes

A API de CNPJ usa banco de dados?

O guia diz que não há servidor de banco entre o pedido e a resposta. A base da Receita fica em arquivos jsonW, lidos direto pelo servidor. O código do servidor não é público.

Quanto tempo leva uma consulta na API de CNPJ?

O guia mede 0,24 ms na mediana para montar uma ficha, só no servidor e sem a rede. O tempo que você vê no seu sistema soma a rede até o servidor.

O que significa o cabeçalho x-base-cnpj?

É o mês da base da Receita, no formato AAAA-MM. Na chamada feita em 15/11/2026, o valor foi 2026-10.

Fontes

Conheça: API de CNPJ grátis da Wortic.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.