API de CNPJ gratuita vs paga: quando a ReceitaWS não é suficiente para sua empresa

A maioria dos desenvolvedores começa consultando CNPJ da mesma forma: abre o Google, encontra a ReceitaWS, a BrasilAPI ou o CNPJ.ws, testa o endpoint gratuito e coloca em produção. Funciona, é rápido e custa zero. Faz todo sentido para um MVP ou para validar uma ideia.

O problema aparece quando o projeto cresce. Às vezes no volume, às vezes nos dados que você precisa retornar, às vezes na confiabilidade que o produto exige. E aí a conta gratuita começa a cobrar de outras formas.

O que as principais APIs gratuitas de CNPJ entregam

As três opções mais usadas pela comunidade brasileira são a ReceitaWS, a BrasilAPI e o CNPJ.ws. Todas retornam dados públicos da Receita Federal: razão social, situação cadastral, endereço da sede, CNAEs, natureza jurídica e data de abertura.

A BrasilAPI é a mais popular entre desenvolvedores open source (mais de 10 mil estrelas no GitHub) e não exige nenhuma autenticação. A ReceitaWS é a marca mais reconhecida no segmento, integrada em ferramentas no-code como n8n e Pipefy. O CNPJ.ws tem escopo similar à ReceitaWS mas retorna mais campos no plano gratuito, incluindo sócios e regime tributário.

Para validar se um CNPJ existe e está ativo antes de cadastrar um fornecedor, qualquer uma das três resolve.

Onde aparecem os limites

O primeiro limite é o rate limiting. ReceitaWS e CNPJ.ws têm cotas por minuto no plano gratuito. Para um sistema que processa poucos CNPJs por vez, raramente é problema. Para um onboarding em lote ou um fluxo com pico de volume, você vai bater no teto e começar a receber erros 429. A BrasilAPI não documenta limites, mas também não tem SLA.

O segundo limite é mais estrutural: essas APIs só retornam dados de CNPJ. Não existe endpoint de CPF. Se o seu processo precisa validar os sócios da empresa pelo CPF deles, confirmar endereço pessoal do responsável, ou checar telefone e e-mail do tomador de crédito, você vai precisar de outra solução de qualquer jeito.

O terceiro ponto é disponibilidade. Serviços gratuitos não têm compromisso de uptime. Em produção, uma instabilidade no serviço externo pode travar o seu próprio sistema. Dependendo do produto, isso é um risco aceitável. Dependendo não.

Quando o CNPJ não é suficiente

Tem um padrão que aparece bastante em fintechs e empresas de crédito: o processo de análise começa pelo CNPJ da empresa (natureza jurídica, situação cadastral, tempo de operação), mas logo precisa dos dados dos sócios também. Nome completo, endereço atualizado, se a pessoa física tem outras empresas abertas.

Para isso você precisa de dados de CPF. E aí a API gratuita de CNPJ já não ajuda mais.

O mesmo acontece em RH e background check: você confirma os dados da empresa onde o candidato diz ter trabalhado via CNPJ, mas quer validar os dados pessoais do próprio candidato via CPF. São dois tipos de consulta, dois tipos de dado, em um fluxo só.

O que muda com uma API paga

A diferença principal não é só o rate limit mais alto. É o escopo dos dados.

A API do Consulta Turbo tem os dois endpoints no mesmo lugar: CNPJ e CPF. A consulta de CNPJ retorna razão social, sócios com qualificação e data de entrada, filiais com endereço e situação individual, regime tributário (Simples/MEI) e CNAEs. A consulta de CPF retorna nome completo, histórico de endereços, telefones (celular e fixo) e e-mails.

Em vez de integrar duas APIs de fontes diferentes e gerenciar dois fluxos de autenticação, você usa um Bearer token e dois endpoints. Menos código, menos ponto de falha.

# CNPJ: razão social, sócios, filiais, regime tributário
curl -s -H "Authorization: Bearer ct_live_SEU_TOKEN" https://consultaturbo.com.br/api/v1/companies/12345678

# CPF: nome, endereços, telefones, e-mails
curl -s -H "Authorization: Bearer ct_live_SEU_TOKEN" https://consultaturbo.com.br/api/v1/people/12345678900

Como funciona o modelo de preço

Não tem mensalidade nem contrato mínimo. Você compra créditos e usa conforme a demanda. Consulta de CNPJ custa 0,5 crédito. Consulta de CPF custa 1 crédito. Os créditos não expiram.

Para um time que está começando, dá para comprar um pacote pequeno, integrar e validar o fluxo inteiro antes de qualquer compromisso maior. Se o volume crescer, o preço por crédito cai.

Qual usar então

Se você só precisa de dados públicos de CNPJ, volume baixo e não tem exigência de SLA, as APIs gratuitas continuam sendo uma escolha razoável. Não tem motivo para pagar pelo que você consegue de graça.

Se o fluxo precisa de dados de CPF junto com CNPJ, ou se o volume cresceu ao ponto de o rate limiting virar problema frequente, ou se você precisa de uma API com disponibilidade previsível para não deixar o produto parado quando o serviço externo cair, faz sentido olhar para uma opção paga.

A conta é simples: quanto custa uma hora de engenharia gerenciando erros de rate limit e instabilidade de serviço gratuito, versus o custo por consulta numa API com mais garantias?