Como a API responde sem banco de dados
A API lê a base da Receita direto de arquivos jsonW, o formato de dados da Wortic, grátis para usar. Não há servidor de banco entre o pedido e a resposta.
Publicado em .
Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.
Uma consulta de CNPJ costuma passar por um banco de dados. Aqui não: o servidor da API, escrito em C, abre os arquivos jsonW da base uma vez e responde lendo direto deles.
Os números, medidos
| Medida | Valor | Como foi medido |
|---|---|---|
| Montar uma ficha | 0,24 ms (mediana) | No servidor, sem a rede, 200 CNPJs distintos, 14/11/2026 |
| Busca por nome | 0,20 ms (mediana) | No servidor, sem a rede, 10 termos, 14/11/2026 |
| Primeira leitura de uma região do arquivo | até 23,8 ms para 95% das fichas | No mesmo teste |
| Estabelecimentos na base | 73.809.379 | Contagem da base aberta carregada |
O tempo que você vê no seu sistema soma a rede até o servidor. Os números acima são só a parte do servidor.
O jsonW, em números publicados
- 6,6 vezes menor que o mesmo dado em JSONL sem compressão (100 mil registros, mediana de 10 rodadas, versão 1.3.11, 13/11/2026).
- Na base inteira de marcas do INPI, 55,3 milhões de linhas: o arquivo jsonW ficou 4,9 vezes menor que o CSV, e 6,5 vezes no nível máximo.
Método e limites de cada medida: jsonw.org/paper.
Use no seu sistema
O jsonW é grátis para usar dentro do seu produto. Se você guarda as fichas desta API para consultar depois, guardar em jsonW deixa a busca rápida sem subir um banco.
# Node.js
npm install @wortictecnologia/jsonw
A ferramenta wjsw roda no macOS, no Linux e no Windows. Tudo em jsonw.org.
Perguntas e respostas
Por que a API de CNPJ da Wortic é rápida?
Porque lê a base direto de arquivos jsonW, sem servidor de banco no caminho. No servidor, a mediana para montar uma ficha foi de 0,24 ms, medida em 14/11/2026 com 200 CNPJs distintos.
O que é jsonW?
É o formato de dados da Wortic: arquivo em colunas, lido direto do disco, com busca embutida. É grátis para usar no seu produto e conversa com JSON. Detalhes em jsonw.org.
Posso usar jsonW para guardar as respostas da API?
Sim. Ele tem SDK em C, C++, Python, Node.js, PHP, Go, Rust, Java, Kotlin e Swift, e converte de e para JSON com um comando.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA