BitBusca › Desenvolvedores › API de empresas (leads B2B)
Filtre a base de empresas por UF, cidade, bairro, CNAE, porte, data de abertura e presença de telefone ou e-mail, e receba páginas de resultados em JSON. Com webhook quando abre empresa nova no seu filtro.
Hoje: Lista de empresas velha, vendedor ligando para CNPJ baixado, concorrente chegando primeiro no cliente novo. Com a API: Você filtra por ramo, cidade e porte e recebe um webhook quando abre empresa nova no seu filtro.
1 crédito por página · escopo empresas:lista · planos a partir de R$ 19,90/mês. Chave de teste grátis.
curl https://api.bitbusca.net/api/v1/empresas?uf=MS&municipio=CAMPO%20GRANDE&cnae=5611201&aberturaDias=30&pageSize=25 \
-H "Authorization: Bearer $BITBUSCA_API_KEY"
{
"total": 87,
"page": 0,
"pageSize": 25,
"items": [
{
"cnpj": "00000000000191",
"razaoSocial": "RESTAURANTE EXEMPLO LTDA",
"abertura": "2026-10-02",
"porte": "ME",
"bairro": "CENTRO",
"telefone": "(67) 9000-0000"
}
]
}
Exemplo fictício, formato resumido. Referência completa: OpenAPI.
cnpj — A chave para abrir a ficha completa, com sócios.razaoSocial — Quem é a empresa, para o vendedor saber com quem fala.abertura — Quão nova é: quem abriu ontem ainda está escolhendo contador, fornecedor e sistema.porte — Para separar o pequeno do grande e mandar a oferta certa.bairro — Para dividir a carteira por região ou rota de visita.telefone · email — O contato publicado no cadastro da empresa, quando houver.total — Quantas empresas batem com o filtro: o tamanho do seu mercado.GET /v1/empresas?uf=&municipio=&cnae=&porte=&aberturaDias= — Página de empresas que batem com o filtro (1 crédito por página)GET /v1/cnpj/{cnpj} — Ficha completa (com sócios) de uma empresa da lista (1 crédito)
Crie uma tela de prospecção com filtros de UF, cidade, CNAE e "abertas nos últimos N dias". Chame GET /v1/empresas com esses filtros e mostre os resultados paginados numa tabela com botão "ver ficha" que chama GET /v1/cnpj/{cnpj}. Respeite o 429 COTA_DIARIA mostrando "limite de hoje atingido".
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.
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.
Depende do plano: 100 linhas no Sandbox, 300 linhas no Starter, 2.000 linhas no Builder, 10.000 linhas no Scale e 30.000 linhas no Enterprise. Cada página também gasta 1 crédito do pool.
A base pública de CNPJ da Receita Federal, com mais de 71 milhões de estabelecimentos, carregada diariamente.
Os contatos são os publicados no cadastro da empresa. Prospecção B2B é o uso comum; quando o contato for de pessoa (um MEI, por exemplo), siga a LGPD e ofereça a opção de sair. Revender a lista é proibido nos termos.
Porque a API vende o uso, não a cópia da base: o teto cabe com folga em quem prospecta e impede que alguém baixe a base inteira. É também a sua proteção se uma chave vazar.