BitBusca › Desenvolvedores
Os dados do Brasil numa API só
CPF, CNPJ, empresas, advogados, Diário de Justiça, licitações e imóveis em JSON — com chave de teste grátis, webhooks assinados, OpenAPI e conector MCP para Claude, ChatGPT e Cursor.
Pegar chave de teste grátis — sem cartão. Planos a partir de R$ 19,90/mês.
Exemplo de chamada
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.
As APIs
Pessoas
- 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 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)
Veículos
- API de placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
Empresas
- API de CNPJ — Ficha da empresa com quadro de sócios, pelo CNPJ. (1 crédito por CNPJ)
- API de empresas (leads B2B) — Empresas por CNAE, cidade, porte e abertura — leads B2B. (1 crédito por página)
Jurídico
Licitações
Imóveis
Integração
- 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)
Vibecoding: Lovable, Bolt, v0, Cursor, Replit, Claude Code
Cole este prompt na ferramenta de IA:
Quero um app que consulte dados de empresas brasileiras. Crie uma página onde eu digito um CNPJ e vejo razão social, situação, endereço e sócios, usando GET /v1/cnpj/{cnpj} da BitBusca.
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.
Servidor MCP para Claude, ChatGPT e Cursor: https://api.bitbusca.net/api/v1/mcp — como ligar.
Webhooks
- juridico.publicacao — o monitor achou publicação
- licitacoes.edital — o alerta achou edital
- empresas.nova — abriu empresa no seu filtro
- imoveis.alerta — alerta de imóvel
- uso.limite — 80% e 100% do pool de créditos
- conta.plano — assinou, renovou ou venceu
- chave.suspensa — uma chave foi pausada
- teste.ping — para testar o endpoint
Segurança e LGPD
- Chave com escopo e teto — Cada chave nasce só com o que precisa (ex.: só CNPJ) e com teto diário de créditos. Vazou? O estrago fica no que ela podia — e você revoga ou gira na hora.
- IP fixo por chave — A partir do plano com IP fixo, a chave só responde aos IPs ou faixas que você cadastrar.
- Detector de varredura — CPF, CNPJ ou OAB em sequência, ou volume fora do padrão, pausam a chave por 1 hora. Protege a base — e protege você de uma chave vazada sendo usada para raspar dados.
- Leads sem CPF — Leads de pessoas nunca trazem CPF, saem com um canal por vez e não se repetem. Menos dado pessoal circulando, menos risco na LGPD para quem integra.
- Tetos diários nas bases sensíveis — Empresas em lista, advogados e pessoas têm teto por dia, além do pool de créditos. A API vende o uso, não a cópia da base.
- Log de cada chamada — Rota, status, custo e chave de cada chamada ficam no seu painel — sem gravar o dado consultado no log.
Planos
- Starter — R$ 19,90/mês: 500 créditos de API por mês; 30 requisições por minuto · 2 chaves · 2 webhooks; CPF, telefone, nome, placa, CNPJ, CEP, DJEN, licitações e advogados; Empresas em lista: 300 linhas/dia; Servidor MCP para Claude, ChatGPT, Cursor e Lovable + OpenAPI; Log de chamadas por 7 dias
- Builder — R$ 59,90/mês: 2.500 créditos de API por mês; 60 requisições por minuto · 5 chaves · 10 webhooks; CPF, telefone, nome, placa, CNPJ, CEP, DJEN, licitações e advogados; Empresas em lista: 2.000 linhas/dia; Ficha de imóvel do cadastro municipal; Servidor MCP para Claude, ChatGPT, Cursor e Lovable + OpenAPI; IPs fixos por chave; Log de chamadas por 30 dias
- Scale — R$ 149,90/mês: 8.000 créditos de API por mês; 120 requisições por minuto · 15 chaves · 30 webhooks; CPF, telefone, nome, placa, CNPJ, CEP, DJEN, licitações e advogados; Empresas em lista: 10.000 linhas/dia; Leads de pessoas físicas: 500 contatos/dia; Ficha de imóvel do cadastro municipal; Servidor MCP para Claude, ChatGPT, Cursor e Lovable + OpenAPI; IPs fixos por chave; Log de chamadas por 60 dias
- Enterprise — R$ 399,90/mês: 25.000 créditos de API por mês; 300 requisições por minuto · 50 chaves · 100 webhooks; CPF, telefone, nome, placa, CNPJ, CEP, DJEN, licitações e advogados; Empresas em lista: 30.000 linhas/dia; Leads de pessoas físicas: 1.000 contatos/dia; Ficha de imóvel do cadastro municipal; Servidor MCP para Claude, ChatGPT, Cursor e Lovable + OpenAPI; IPs fixos por chave; Log de chamadas por 90 dias
No anual você paga 10 mensalidades e usa 12 meses (2 meses grátis). Recargas: +1.000 créditos por R$ 29,90 ou +5.000 créditos por R$ 119,90. Degustação (sandbox): 7 dias com 50 créditos reais, 10 requisições por minuto, 2 chaves e 1 webhook, uma vez por conta. Pix ou cartão, sem fidelidade.
Perguntas frequentes
Como consigo uma chave de teste?
Crie a conta (ou entre), abra o painel do desenvolvedor e gere a chave de teste (bk_test_…). Ela é grátis, não pede cartão e devolve dados fictícios no mesmo formato da produção — dá para montar o app inteiro com ela.
Qual a diferença entre chave de teste e sandbox?
A chave de teste nunca toca a base real: dados fictícios, 30 requisições por minuto, sem gastar nada, e continua valendo depois do sandbox. O sandbox é a degustação com dado real: 7 dias com 50 créditos reais, 10 requisições por minuto, 2 chaves e 1 webhook, uma vez por conta.
Como funcionam os créditos?
Cada plano traz um pool mensal de créditos (ciclo de 30 dias, não acumula). Cada rota tem um custo — CPF e CNPJ custam 1 crédito, placa 5 créditos, página de busca de editais 1 crédito. 404 e erro do nosso lado não cobram. O crédito sai a partir de R$ 0,016 no plano maior.
E se os créditos acabarem antes do fim do mês?
Você recebe aviso por e-mail e webhook (uso.limite) em 80% e 100%. Dá para comprar recarga avulsa (+1.000 créditos por R$ 29,90 ou +5.000 créditos por R$ 119,90), que não expira enquanto houver plano ou sandbox, ou subir de plano.
Quanto custa?
Planos a partir de R$ 19,90/mês (Starter, 500 créditos). No anual você paga 10 mensalidades e usa 12 meses (2 meses grátis). Pix ou cartão, sem fidelidade.
Funciona com Lovable, Bolt, v0, Cursor ou Replit?
Sim. Cole o prompt desta página na ferramenta: ele aponta para o OpenAPI (https://api.bitbusca.net/api/v1/openapi.json) e explica a autenticação. Só não deixe a chave no código do navegador — use a função de servidor da ferramenta (edge function, API route).
Tem conector para Claude e ChatGPT?
Tem: o servidor MCP em https://api.bitbusca.net/api/v1/mcp. Funciona no Claude, no ChatGPT, no Cursor e em outros clientes MCP, com a mesma chave, cobrança e limites da API.
Os dados pessoais estão de acordo com a LGPD?
O acesso é pessoal e identificado (conta com CPF e WhatsApp confirmados), cada chamada fica registrada, leads de pessoas não trazem CPF e há tetos diários nas bases sensíveis. O uso precisa de finalidade legítima e é de responsabilidade de quem consulta.
Já uso a API do plano Pro. Muda alguma coisa?
Não. As chaves antigas (bk_…) do plano Pro continuam funcionando com os créditos por dia do plano de consultas. Os planos de desenvolvedor trazem o pool mensal, os módulos (DJEN, licitações, advogados, empresas, imóveis), webhooks e MCP.
Posso cancelar quando quiser?
Sim. Sem fidelidade: o plano vale pelo período pago e você escolhe se renova.
Uso aceitável
Pode:
- Consultar para uma finalidade legítima (cadastro, crédito, prevenção a fraude, cobrança, processo, compliance)
- Guardar o que o seu sistema precisa para essa finalidade
- Usar a API dentro do seu produto, para os seus clientes
Não pode:
- Revender ou redistribuir os dados ou o acesso à API
- Montar base derivada (copiar a base aos poucos)
- Varrer documentos em sequência ou contornar os tetos com várias contas
- Usar dado pessoal para finalidade ilegítima ou discriminatória
Violação suspende a chave e, na reincidência, a conta. Termos de Uso · llms.txt