BitBusca › Desenvolvedores › API de busca por nome
Ache a pessoa pelo nome completo e separe os homônimos
Mande o nome completo e receba as pessoas encontradas, com nascimento e nome da mãe para separar homônimos. Para localizar parte, conferir cadastro e completar ficha.
Hoje: Só o nome na mão, e várias pessoas com o mesmo nome. Com a API: A lista volta com nascimento e nome da mãe de cada uma: escolha a certa e siga com o CPF.
1 crédito por busca · escopo consultas:pessoa · planos a partir de R$ 19,90/mês. Chave de teste grátis.
Homônimos
Nome comum traz várias pessoas: use o nascimento e o nome da mãe para escolher a certa antes de seguir. Nome incompleto ou com erro de grafia pode não trazer resultado.
Buscar pelo nome
curl https://api.bitbusca.net/api/v1/nome/MARIA%20EXEMPLO%20DE%20SOUZA \
-H "Authorization: Bearer $BITBUSCA_API_KEY"{
"tipo": "NOME",
"consulta": "MARIA EXEMPLO DE SOUZA",
"custo": 1,
"dados": [
{ "nome": "MARIA EXEMPLO DE SOUZA", "nascimento": "1988-03-14", "mae": "JOANA EXEMPLO" },
{ "nome": "MARIA EXEMPLO DE SOUZA", "nascimento": "1961-07-02", "mae": "ANA EXEMPLO" }
]
}Exemplo fictício, formato resumido. Referência completa: OpenAPI.
Por que integrar
- Homônimo separado — Nascimento e nome da mãe lado a lado para escolher a pessoa certa.
- Do nome ao CPF — Cada resultado traz o CPF para seguir com a API de CPF.
- Base antiga recuperada — Cadastro que só tinha o nome volta a ser útil.
- Paga só o que encontra — 1 crédito por busca. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.
Para quem é
- Escritórios de advocacia — O processo tem o nome da parte, mas não o documento. Localize a parte para citação, acordo ou execução.
- Times de dados e CRM — Base antiga só com nome não serve para nada. Recupere o CPF e complete a ficha.
- Due diligence e compliance — Assinar com o representante sem saber quem ele é. Confira a pessoa antes de assinar.
O que você recebe
nome— O nome completo como está no cadastro de cada pessoa encontrada.nascimento— O primeiro filtro contra homônimo.mae— O desempate quando o nascimento não basta.cpf— A chave para seguir com a API de CPF e completar a ficha.
Busca de pessoa com trava contra raspagem
Busca por nome é ferramenta de localização, não de coleta: por isso tem detector de varredura e registro de cada chamada. É o que faz a integração passar no jurídico.
- Localizar a parte de um processo
- Completar cadastro de quem já é cliente
- Due diligence antes de contrato
- Conta identificada, com CPF e WhatsApp confirmados, por trás de cada chave
- Detector de varredura: documentos ou números em sequência pausam a chave por 1 hora
- Cada chamada registrada no log da sua conta, sem gravar o dado consultado
- Termos proíbem revenda, redistribuição e base derivada
O que entrega
- Lista de pessoas encontradas
- Nascimento e nome da mãe de cada uma (para separar homônimos)
- CPF de cada resultado, para seguir com a API de CPF
Endpoints e custo
GET /v1/nome/{nome}— Pessoas com aquele nome completo (URL-encoded) (1 crédito)
Limites e proteção
- 1 crédito por busca; 404 não cobra.
- Varredura de nomes em massa é detectada e pausa a chave por 1 hora.
- Uso com finalidade legítima, conforme a LGPD.
Casos de uso
- Localizar a parte — Escritórios acham a parte de um processo a partir do nome.
- Completar cadastro antigo — Base só com nome? Recupere o CPF para seguir com o resto.
- Due diligence — Confira quem é o sócio ou o representante antes de assinar.
Prompt para Lovable, Cursor ou Bolt
Crie uma busca de pessoas: o usuário digita o nome completo, você chama GET /v1/nome/{nome} (URL-encoded) e mostra a lista com nascimento e nome da mãe, para ele escolher a pessoa certa.
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.
Como evito homônimos?
Mande o nome completo, com todos os sobrenomes, e use o nascimento e o nome da mãe de cada resultado para escolher a pessoa certa antes de seguir com a API de CPF.
Buscar pessoa pelo nome é permitido pela LGPD?
É, com finalidade legítima e base legal (localizar parte de processo, completar cadastro de cliente, due diligence). Varredura de nomes em massa pausa a chave, e os termos proíbem montar base derivada.
Tem limite de consultas por dia?
O limite é o pool mensal de créditos do plano (1 crédito por busca) e as requisições por minuto de cada plano. Você ainda pode pôr um teto diário de créditos em cada chave. O que pausa a chave é varredura: documentos em sequência ou volume fora do padrão.
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 placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
- 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)
- 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)