BitBusca › Desenvolvedores › API de placa
Consulta de placa por API: o veículo conferido antes do negócio
Mande a placa (antiga ou Mercosul) ou o número do motor e receba marca, modelo, ano, cor, chassi e situação. Para lojas, despachantes, seguros e logística.
Hoje: Vendedor digitando modelo e ano à mão, cotação feita com o carro errado, veículo conferido só depois do negócio. Com a API: A placa entra; marca, modelo, ano, cor e situação voltam. A cotação se preenche e a compra é conferida antes.
5 créditos por placa · escopo consultas:veiculo · planos a partir de R$ 19,90/mês. Chave de teste grátis.
Consultar uma placa
curl https://api.bitbusca.net/api/v1/placa/ABC1D23 \
-H "Authorization: Bearer $BITBUSCA_API_KEY"{
"tipo": "PLACA",
"consulta": "ABC1D23",
"custo": 5,
"dados": {
"marca": "VW",
"modelo": "GOL 1.0",
"anoFabricacao": 2016,
"anoModelo": 2017,
"cor": "PRATA",
"situacao": "EM CIRCULAÇÃO",
"municipio": "CAMPO GRANDE/MS"
}
}Exemplo fictício, formato resumido. Referência completa: OpenAPI.
Por que integrar
- Cotação preenchida — O cliente digita a placa; marca, modelo, ano e cor entram sozinhos.
- Placa antiga e Mercosul — E pelo número do motor (5 créditos), quando a placa não está à mão.
- Situação do veículo — Saiba se está em circulação antes de fechar a troca ou a apólice.
- Paga só o que encontra — 5 créditos por placa. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.
Para quem é
- Lojas e concessionárias — Carro de troca avaliado com dado digitado errado. Marca, modelo, ano e situação conferidos antes de fechar a troca.
- Seguradoras e corretoras — O cliente desiste no meio do formulário de cotação. Só a placa: o resto da cotação se preenche.
- Logística e transportadoras — Motorista chega com veículo diferente do combinado. Veículo validado na coleta, pelo celular.
- Despachantes — Conferência manual de cada veículo. Dados do veículo direto no seu sistema.
O que você recebe
marca · modelo— Identifica o veículo na cotação, no anúncio ou na avaliação.anoFabricacao · anoModelo— Base de preço e de aceitação no seguro.cor— Confere com o carro que está na sua frente.situacao— Se está em circulação: o primeiro alerta antes de comprar.municipio— Onde o veículo está registrado: transferência e cotação regional.
O que entrega
- Marca e modelo
- Ano de fabricação e modelo
- Cor e combustível
- Chassi (parcial) e Renavam
- Situação e município/UF
Endpoints e custo
GET /v1/placa/{placa}— Veículo pela placa (antiga ou Mercosul) (5 créditos)GET /v1/motor/{numero}— Veículo pelo número do motor (5 créditos)
Limites e proteção
- 5 créditos por placa e 5 créditos por motor; 404 não cobra.
- Placas em sequência são detectadas como varredura e pausam a chave por 1 hora.
Casos de uso
- Lojas e despachantes — Confira o veículo antes de fechar a compra.
- Seguros — Preencha a cotação com marca, modelo e ano a partir da placa.
- Logística — Valide o veículo do motorista na coleta.
Prompt para Lovable, Cursor ou Bolt
Crie uma cotação de seguro em que, ao digitar a placa, marca, modelo, ano e cor do veículo sejam preenchidos com GET /v1/placa/{placa}.
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.
Aceita placa Mercosul?
Sim: a antiga (ABC1234) e a Mercosul (ABC1D23), sem hífen.
Qual a diferença entre placa e motor?
A placa (5 créditos) é a consulta do dia a dia. O número do motor (5 créditos) serve quando a placa não está à mão ou para conferir se o motor bate com o veículo.
Tem limite de consultas por dia?
O limite é o pool mensal de créditos do plano (5 créditos por placa) 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 busca por nome — Pessoas encontradas pelo nome, com dados para separar homônimos. (1 crédito por busca)
- 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)