Guias de integração

Guias práticos, orientados a tarefa, para consultar CNPJ pela API da CNPJAPI na sua linguagem. Cada guia mostra uma chamada real ao endpoint GET https://api.cnpjapi.com.br/{cnpj}, a autenticação por API key e como ler a resposta em JSON.

Para a referência completa (campos, limites, erros), veja a documentação da API.

Escolha a sua linguagem

• Python - com a biblioteca requests.
• Node.js - com fetch nativo.
• C# / .NET - com HttpClient.
• PHP - com cURL.
• Go - com net/http.
• Java - com java.net.http.HttpClient.

Muitos CNPJs?

• Consultar em lote - até 20 CNPJs numa única chamada (plano pago). Sem plano pago, o padrão é uma chamada por CNPJ, respeitando o rate limit.

Além da consulta de CNPJ

• Migrar da ReceitaWS - já usa a ReceitaWS? Troque só o host; a resposta vem no mesmo formato, campo a campo.
• Consultar Inscrição Estadual (IE) - a IE de um CNPJ na fonte oficial da SEFAZ, por UF ou varredura nacional.

Código no GitHub

Os exemplos completos e rodáveis de todas as linguagens ficam no repositório oficial: https://github.com/guidi-sistemas/cnpjapi-examples.

Antes de começar

Você vai precisar de uma API key. Crie sua conta gratuita em https://app.cnpjapi.com.br, gere a chave e envie-a no cabeçalho Authorization: Bearer de cada requisição (veja Autenticação).