BitBusca › Desenvolvedores › API de CNPJ
Consulta de CNPJ com os sócios: a empresa conferida antes do contrato
Mande o CNPJ e receba razão social, nome fantasia, situação, atividade (CNAE), endereço, porte e o quadro de sócios. Da base pública da Receita Federal, atualizada todo dia.
Hoje: Fornecedor cadastrado à mão, venda a prazo para empresa baixada, sócio desconhecido assinando o contrato. Com a API: O CNPJ entra; razão social, situação, CNAE, endereço e sócios voltam. O cadastro se preenche e a decisão sai com dado.
1 crédito por CNPJ · escopo consultas:empresa · planos a partir de R$ 19,90/mês. Chave de teste grátis.
Consultar um CNPJ
curl https://api.bitbusca.net/api/v1/cnpj/00000000000191 \
-H "Authorization: Bearer $BITBUSCA_API_KEY"{
"tipo": "CNPJ",
"consulta": "00.000.000/0001-91",
"custo": 1,
"dados": {
"razaoSocial": "EMPRESA EXEMPLO LTDA",
"situacao": "ATIVA",
"abertura": "2015-03-10",
"cnae": "5611-2/01 Restaurantes",
"porte": "ME",
"socios": [{ "nome": "FULANO EXEMPLO", "qualificacao": "Sócio-Administrador" }]
}
}Exemplo fictício, formato resumido. Referência completa: OpenAPI.
Por que integrar
- Cadastro sem digitação — Razão social, endereço e atividade entram sozinhos no ERP ou no CRM.
- Quem está por trás — Quadro de sócios com qualificação e data de entrada, na mesma chamada.
- Base atualizada todo dia — Da base pública da Receita Federal, com carga diária: empresa recém-aberta já aparece.
- Paga só o que encontra — 1 crédito por CNPJ. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.
Para quem é
- Cadastro de fornecedor (ERP e compras) — Compras cadastrando fornecedor à mão e errando o endereço da nota. Digite o CNPJ: razão social, endereço e CNAE entram sozinhos.
- Prospecção e vendas B2B — Lead PJ sem saber o porte nem o ramo. Porte, CNAE e abertura para qualificar antes de ligar.
- Compliance e análise de crédito — Vender a prazo ou contratar sem saber se a empresa está ativa e quem manda nela. Situação, abertura e quadro de sócios antes de assinar.
O que você recebe
razaoSocial— O nome que vai na nota fiscal e no contrato.situacao— Ativa, baixada, inapta: a primeira trava antes de vender ou contratar.abertura— Empresa de dois meses e de vinte anos têm riscos diferentes.cnae— O ramo de verdade: confirma se o fornecedor faz o que diz.porte— ME, EPP ou demais: o tamanho do cliente e as regras de compra.socios— Quem manda na empresa, para conferir com quem está assinando.
O que entrega
- Razão social e nome fantasia
- Situação cadastral e data de abertura
- Atividade principal e secundárias (CNAE)
- Endereço completo, porte e natureza jurídica
- Quadro de sócios com qualificação e data de entrada
- CEP com coordenadas (grátis)
Endpoints e custo
GET /v1/cnpj/{cnpj}— Ficha da empresa com sócios (1 crédito)GET /v1/cep/{cep}— Endereço e coordenadas do CEP (grátis)
Limites e proteção
- 1 crédito por CNPJ; 404 não cobra.
- CNPJs em sequência são detectados como varredura e pausam a chave por 1 hora.
- Para listas de empresas, use a API de empresas (com teto diário de linhas).
Casos de uso
- ERP e CRM — Cadastre fornecedor ou cliente PJ digitando só o CNPJ.
- Análise de crédito — Situação, abertura e sócios antes de vender a prazo.
- Compliance — Confira quem está por trás da empresa antes de contratar.
Prompt para Lovable, Cursor ou Bolt
Crie um cadastro de fornecedores: ao digitar o CNPJ, preencha razão social, situação, endereço e mostre os sócios numa lista, usando GET /v1/cnpj/{cnpj} (só números).
Use a API da BitBusca (base https://api.bitbusca.net/api). A especificação OpenAPI está em https://api.bitbusca.net/api/v1/openapi.json.
Autentique com o cabeçalho "Authorization: Bearer <chave>", lendo a chave da variável de ambiente BITBUSCA_API_KEY.
Nunca coloque a chave no código do navegador: faça as chamadas por uma função de servidor (edge function, API route ou backend).
Trate os erros pelo campo "code" da resposta: 402 NO_CREDITS (sem créditos), 429 RATE (respeite o cabeçalho Retry-After), 429 COTA_DIARIA (teto do dia atingido), 404 NOT_FOUND (mostre "nada encontrado", não é cobrado).
Comece com a chave de teste (bk_test_…), que devolve dados fictícios e não gasta créditos.Perguntas frequentes
Dá para testar sem pagar?
Sim. A chave de teste (bk_test_…) é grátis, não expira com o sandbox e devolve dados fictícios no mesmo formato da produção — dá para montar a tela inteira sem gastar nada. Quando quiser dado real, ative o sandbox: 7 dias com 50 créditos reais, 10 requisições por minuto, 2 chaves e 1 webhook, uma vez por conta.
Pago por chamada que não encontra nada?
Não. Resposta 404 (nada encontrado) e erro do nosso lado (5xx) não gastam créditos: o débito é estornado na hora.
De onde vêm os dados?
Da base pública de CNPJ da Receita Federal, com carga diária: empresas recém-abertas aparecem logo depois de registradas.
CNPJ não é dado aberto? Por que pagar?
É, e para consultar um CNPJ isolado existem caminhos gratuitos. A BitBusca faz sentido quando o seu sistema precisa do CNPJ e de mais alguma coisa (sócio, telefone, placa, processo, edital), com uma chave, um formato de erro e uma fatura só.
Tem limite por dia?
A ficha por CNPJ gasta 1 crédito do pool mensal, dentro das requisições por minuto do plano, e você pode pôr teto diário em cada chave. Para listas de empresas, use a API de empresas, que tem teto diário de linhas.
Outras APIs
- API de CPF — Cadastro da pessoa física a partir do CPF, em JSON. (1 crédito por CPF)
- API de telefone — Titular e endereço a partir do número com DDD. (1 crédito por número)
- API de busca por nome — Pessoas encontradas pelo nome, com dados para separar homônimos. (1 crédito por busca)
- API de placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
- API de empresas (leads B2B) — Empresas por CNAE, cidade, porte e abertura — leads B2B. (1 crédito por página)
- API de leads de pessoas — Contatos por região, sem CPF e sem repetição, a partir do Scale. (1 crédito a cada 10 contatos, a partir do Scale)
- API de advogados (OAB) — Ficha do advogado pela OAB e busca por nome. (1 crédito por ficha)
- API do DJEN (publicações e prazos) — Publicações por OAB, parte ou processo, monitores e prazos. (1 crédito por página de busca)
- API de licitações (editais abertos) — Editais abertos, itens, análise por IA e alertas. (1 crédito por página)
- API de imóveis (cadastro municipal) — Ficha do lote do cadastro da prefeitura — 7 cidades. (5 créditos por ficha, a partir do Builder)
- Servidor MCP (conector para IAs) — Conector para Claude, ChatGPT, Cursor e outras IAs. (O custo de cada ferramenta é o da rota)
- Webhooks — Eventos assinados com HMAC: intimação, edital, empresa nova. (Sem custo por entrega)