BitBusca › Desenvolvedores › API de advogados (OAB)
Consulta de OAB pela API: o advogado conferido na hora
Mande UF e número da inscrição e receba a ficha do advogado: nome, situação, tipo de inscrição e seccional. Ou busque pelo nome, com páginas de até 20 resultados.
Hoje: Cadastro de advogado aceito sem conferir a inscrição; diligência passada para quem não pode atuar. Com a API: UF e número entram; nome, situação e seccional voltam. O seu sistema só libera inscrição regular.
1 crédito por ficha · escopo advogados · planos a partir de R$ 19,90/mês. Chave de teste grátis.
Conferir uma inscrição
curl https://api.bitbusca.net/api/v1/advogados/MS00000 \
-H "Authorization: Bearer $BITBUSCA_API_KEY"
{
"oab": "MS 00000",
"nome": "ADVOGADA EXEMPLO DA SILVA",
"tipo": "Advogado",
"situacao": "REGULAR",
"seccional": "MS"
}
Exemplo fictício, formato resumido. Referência completa: OpenAPI.
Por que integrar
- Inscrição conferida — Situação, tipo de inscrição e seccional numa chamada.
- 1,9 milhão de advogados — Base do Cadastro Nacional dos Advogados mantida por nós: a consulta não depende de outro site no ar.
- Busca por nome — Até 20 resultados por página, para achar a inscrição de quem você só sabe o nome.
- Paga só o que encontra — 1 crédito por ficha. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.
Para quem é
- Legaltechs e plataformas jurídicas — Qualquer um se cadastra dizendo que é advogado. Só libera quem tem inscrição regular.
- Correspondentes e diligências — Diligência repassada a colega com inscrição irregular. Inscrição conferida antes de repassar.
- Departamentos jurídicos — Lista de escritórios contratados sem conferência. Cada advogado contratado conferido pelo sistema.
O que você recebe
oab — A inscrição formatada (UF + número), pronta para mostrar.nome — Confere com quem se cadastrou ou assinou.tipo — Advogado ou estagiário, por exemplo: o que a pessoa pode assinar.situacao — Regular ou não: libera ou trava o cadastro.seccional — Onde a inscrição foi feita.
Base de advogados para conferir, não para mailing
A busca por nome não traz contato e a ficha por inscrição tem teto diário. É essa regra que faz a integração passar sem susto no jurídico de quem contrata você.
- Validar a OAB de quem se cadastra
- Conferir correspondente antes da diligência
- Manter a lista de contratados conferida
- Teto de fichas por dia: 10 no Sandbox, 50 no Starter, 300 no Builder, 1.500 no Scale e 5.000 no Enterprise
- Busca por nome sem contato
- Inscrições em sequência pausam a chave por 1 hora
- Termos proíbem montar lista de contatos ou base derivada
O que entrega
- Nome e número de inscrição
- Seccional (UF) e tipo de inscrição
- Situação da inscrição
- Contatos públicos só na ficha por OAB, nunca na busca
Endpoints e custo
GET /v1/advogados/{oab} — Ficha pela inscrição (UF + número, ex.: MS12345) (1 crédito)GET /v1/advogados?nome=&uf= — Busca por nome, até 20 por página, sem contatos (1 crédito por página)
Limites e proteção
- Teto de fichas por dia: 10 no Sandbox, 50 no Starter, 300 no Builder, 1.500 no Scale e 5.000 no Enterprise.
- Busca paginada (até 20 por página) e sem contatos; contato só na ficha por OAB.
- Inscrições em sequência são detectadas como varredura e pausam a chave por 1 hora.
Casos de uso
- Legaltechs — Valide a OAB de quem se cadastra na sua plataforma.
- Correspondentes — Confira a inscrição do colega antes de passar uma diligência.
- Departamentos jurídicos — Mantenha a lista de escritórios contratados conferida.
Prompt para Lovable, Cursor ou Bolt
Crie uma validação de cadastro de advogados: o usuário informa UF e número da OAB, você chama GET /v1/advogados/{UF}{numero} (ex.: MS12345) e mostra nome e situação; só libera o cadastro com situação regular.
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.
De onde vem a base?
Do Cadastro Nacional dos Advogados, mantido na nossa própria base — a consulta não depende de acesso à OAB na hora.
Por que a busca por nome não traz contato?
Para que ninguém monte uma lista de contatos de advogados a partir da busca. O contato público aparece só na ficha por inscrição, com teto diário.
Posso usar para mandar e-mail a advogados?
A API não foi feita para isso: a busca por nome não traz contato e a ficha por inscrição tem teto diário. Para conferir e cadastrar advogado, é o caminho certo.
Quantas fichas posso puxar por dia?
Depende do plano: 10 no Sandbox, 50 no Starter, 300 no Builder, 1.500 no Scale e 5.000 no Enterprise. A busca por nome gasta 1 crédito por página.
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 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 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)
Todas as APIs e os planos