BrasilAPI, ReceitaWS, CNPJ.ws ou uma API paga?

Existem boas APIs gratuitas de CNPJ. Esta página ajuda a decidir quando elas bastam e quando vale pagar por uma chave de API, um preço público e um formato igual para outros países, com os limites da Prometiam ditos de forma clara.

A pergunta certa antes de comparar

Quase todas as APIs de CNPJ respondem à mesma pergunta: dado um número, qual é a razão social e a situação cadastral? A BrasilAPI, a ReceitaWS e a CNPJ.ws são serviços conhecidos que fazem isso, e cada uma tem seus planos, limites e termos de uso, que mudam com o tempo. Por isso esta página não compara preços nem cotas de terceiros: confira os termos atuais de cada serviço antes de decidir. O que ela faz é listar as perguntas que separam um uso eventual de um uso em produção.

• Volume e picos. Quantas consultas por minuto você precisa no fechamento do mês ou numa importação de cadastro? Um limite baixo de requisições é suficiente para um formulário, mas não para uma carga em lote.
• Disponibilidade e suporte. Há um contrato de serviço, um responsável por incidentes, um histórico de status? Para um fluxo de pagamento ou de onboarding, a ausência de garantia é um risco de negócio.
• Origem e atualidade dos dados. A resposta vem de uma consulta ao vivo ou de uma base carregada? Com qual frequência essa base é atualizada?
• Escopo. O que fica de fora: filiais, MEI, sócios, contatos?
• Outros países. Seu sistema atende fornecedores de fora do Brasil? Um formato único evita escrever um adaptador por país.

O que a Prometiam é, e o que ela não é

A Prometiam não consulta a Receita ao vivo. Os dados vêm dos arquivos de dados abertos da Receita Federal, que publica um arquivo completo por mês: a atualização é mensal, não uma consulta ao vivo. Isso dá respostas rápidas e estáveis, e também significa que uma alteração feita hoje na Receita só chega à API na próxima carga. Para o que a maioria das equipes de compliance, financeiro e produto precisa, que é saber se a empresa existe, qual é a razão social, em que situação está e qual é a atividade, isso basta. Para uma decisão em que um dia de diferença importa, confirme o cartão CNPJ na Receita.

Critério	Prometiam
Fonte	Arquivos de dados abertos da Receita Federal, carga mensal
Consulta	Por CNPJ (com ou sem pontuação), pela raiz de 8 dígitos ou por nome
Formato	Mesmo objeto JSON em 27 países, com status padronizado e local_status da Receita
CNPJ alfanumérico	Aceito, com validação rigorosa dos dígitos verificadores
Eventos	Alterações de razão social, situação, natureza jurídica e endereço, com webhook por POST /monitor
Contratação	Chave de API, preço público, teste de 14 dias

Exemplo de consulta

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BR&company_number=33.000.167/0001-01' \
  -H 'Authorization: Bearer rk_live_...'

A resposta traz company_name, status, local_status, legal_form, o endereço e o activity_code em CNAE 2.3. Os nomes dos campos são os da Prometiam, em inglês e iguais em todos os países; se o seu código já consome outra API de CNPJ, reserve um pequeno mapeamento de campos.

Quando uma API gratuita é a melhor escolha

• Protótipos, ferramentas internas de baixo volume e projetos pessoais.
• Casos em que você precisa de campos que não servimos, como o quadro societário ou os telefones, e aceita os termos do serviço que os publica.
• Quando uma consulta ao vivo à fonte, e não uma base mensal, é requisito; veja nos termos de cada serviço como ele obtém os dados.

Quando uma API paga se justifica

• Onboarding e cadastro de fornecedores com volume previsível e necessidade de contrato.
• Equipes que consultam empresas de vários países e querem um só cliente HTTP.
• Monitoramento de carteira: avisos quando um cliente ou fornecedor muda de situação.

O que não entregamos

• Só pessoas jurídicas: o empresário individual, o MEI e as demais pessoas físicas nunca são servidos. A EIRELI é servida.
• Sem quadro societário (QSA), sem sócios e sem administradores, e sem telefone nem e-mail de contato.
• Sem número de IVA: o Brasil não tem um número de IVA ligado ao CNPJ, e uma busca com vat= é recusada.
• Sem avisos de insolvência: o Brasil não é um dos doze mercados de insolvência. Recuperação judicial, falência e liquidação aparecem na situação especial e no status.
• A atividade é a CNAE 2.3 (BR-CNAE-2.3), não a NACE, e nenhum código NACE é derivado dela.
• Uma empresa por raiz de CNPJ, com o CNPJ da matriz; filiais, entidades sem fins lucrativos, órgãos públicos e sucursais de empresas estrangeiras não são servidos.

O teste gratuito dura 14 dias e inclui 500 créditos; é preciso informar um cartão, mas nada é cobrado durante o teste. Depois, o plano Starter custa € 9,99 por mês com 1.000 créditos, o Professional € 29,99 com 10.000 e o Scale € 99,99 com 50.000; o Enterprise tem preço sob consulta. Consultar um registro de empresa custa 1 crédito, cerca de € 0,01 no Starter e a partir de € 0,002 no Scale. Os preços são públicos e o plano anual dá dois meses grátis.

Contains data from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil, published as open data (CC BY). Adapted by Prometiam.

Páginas relacionadas

• API de consulta de CNPJ
• O que é o CNPJ?
• Validador de CNPJ
• CNPJ alfanumérico
• Brazil company data API (inglês)
• Preços

Começar o teste gratuito de 14 dias · Documentação da API

O teste dura 14 dias e inclui 500 créditos. É necessário informar um cartão; nada é cobrado durante o teste e, depois, vale o plano Starter (€ 9,99 por mês), salvo cancelamento.