BitBusca — Brazil data API

Brazil's public and registry data for AI agents: CNPJ companies, B2B leads, court publications (DJEN) and deadlines, public tenders, lawyers (OAB) and property records.

bitbusca.net で表示

ホスト型 MCP サーバー

npx add-mcp 'https://api.bitbusca.net/api/v1/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

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

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)

Licitações

API de licitações (editais abertos) — Editais abertos, itens, análise por IA e alertas. (1 crédito por página)

Imóveis

API de imóveis (cadastro municipal) — Ficha do lote do cadastro da prefeitura — 7 cidades. (5 créditos por ficha, a partir do Builder)

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.

Confiabilidade e cobrança

Falha técnica não cobra — Consulta ou análise que não sai por erro nosso ou da fonte (5xx, tempo esgotado) não gasta crédito; se já tinha sido cobrada, o crédito volta na mesma chamada.
"Nada consta" cobra — Consulta entregue sem restrição ou análise com campos "não encontrado" é resposta: a base foi consultada. Só 404 (alvo inexistente) e falha técnica não cobram.
Análise do Bitinho com custo antes — POST sem confirmar:true devolve a estimativa (grátis: custo, saldo, se já foi paga); com confirmar:true executa. Cobrada uma vez por alvo a cada 30 dias; "pendente" já está pago.
Status público, medido — Disponibilidade por módulo nos últimos 30 dias em bitbusca.net/status e em GET /api/status (JSON, público), com os dias de incidente derivados dos números.
Pendente responde 202 — Ficha de processo na primeira consulta e análises longas podem levar ~30 s: respondem 202 com Retry-After e você chama de novo sem custo adicional.
Incidente visível na hora — Fonte fora do ar dispara aviso interno em minutos; o módulo aparece como indisponível no status e as chamadas respondem 503 com mensagem clara, sem cobrar.

Status da plataforma (disponibilidade medida por módulo)

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.

O que acontece quando uma fonte cai? Tem página de status?

Tem: bitbusca.net/status (e GET /api/status) mostra a disponibilidade medida de cada módulo nos últimos 30 dias. Falha técnica responde 503 e não cobra; se o crédito já tinha saído, volta na mesma chamada.

As análises do Bitinho (edital, publicação, ficha) cobram sem avisar?

Não. Na API e no MCP, o POST sem confirmar:true devolve só a estimativa (custo, saldo e se já foi paga), de graça. Só executa e cobra com confirmar:true — uma vez por alvo a cada 30 dias; rever é grátis.

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

Farejando…