API REST para o seu sistema

Início API de Consulta

API de consulta de placa
direto no seu sistema

Envie a placa e receba em JSON a marca, o modelo, o ano, a cor, o município, o registro de roubo e o valor FIPE. As primeiras 20 consultas são grátis; depois, R$ 0,07 cada. Os relatórios completos do site também saem pela API, no mesmo preço, com aviso por webhook.

Sem mensalidade 20 consultas grátis Webhooks assinados

O que a consulta básica devolve

Os mesmos dados da consulta grátis do site, em campos prontos para o seu sistema, na hora.

Marca, modelo e versão

Como estão no cadastro do veículo, com a descrição da versão.

Ano de fabricação e do modelo

Os dois anos, em número, prontos para filtrar e comparar.

Cor, combustível e tipo

Automóvel, moto, caminhão e os demais tipos do cadastro.

Município e UF

Onde o veículo está registrado.

Registro de roubo ou furto

Um campo verdadeiro ou falso, sem texto para interpretar.

Código e valor FIPE

O código da Tabela FIPE e o valor em reais.

A consulta básica não traz dados do proprietário, chassi nem RENAVAM: esses estão nos relatórios completos. O valor FIPE segue a Tabela FIPE.

Preço da consulta básica pela API

Pague só o que consultar. Sem mensalidade, sem pacote e sem valor mínimo.

20 consultas grátis no cadastro

As primeiras 20 consultas básicas da sua conta pela API não custam nada. Quando acabarem, vale o preço abaixo.

Por consulta

R$ 0,07

Primeira consulta da placa pela sua conta, depois do bônus.

Cobra quando a placa é encontrada e quando não tem cadastro.

Serviço fora do ar não cobra: o valor volta na hora.

Saldo pré-pago por PIX ou cartão, o mesmo do site.

Placas de teste TST0001, TST0002 e TST0003 sem custo.

Consulta grátis que falha não gasta o bônus.

O painel mostra quantas consultas grátis restam.

Para agentes de IA

Como começar: deixe o seu agente de IA integrar

A SKILL ensina a API inteira a qualquer agente: Claude Code, Cursor, ChatGPT, Codex, Gemini, Copilot e outros. Ele lê os endpoints, os exemplos e as regras e escreve a integração no seu sistema.

1

Ative a API e gere uma chave

Crie a conta grátis, aceite os termos da API e gere uma chave de teste no painel. Guarde-a na variável CDP_API_KEY do servidor.

2

Entregue a SKILL ao agente

Baixe o arquivo ou passe o endereço direto para o agente ler.

Baixar a SKILL
3

Peça a integração

Comece com a chave de teste e as placas TST0001 a TST0003, que não custam nada. Depois troque pela chave de produção: as primeiras 20 consultas reais também são grátis.

Cole no seu agente

Leia https://consultadeplaca.net/desenvolvedores/skill.md e integre a API de consulta de placa ao meu sistema. A chave está na variável de ambiente CDP_API_KEY.

No painel ficam os endpoints com exemplos em cURL, PHP, JavaScript e Python, um console de teste, o OpenAPI, os webhooks e o registro de cada pedido.

Para quem é

Para quem confere veículos todos os dias e quer a placa preenchida sem digitar nada.

Revendas e lojas de veículos: cadastro do estoque e avaliação na compra (veja também Para Revendas).

Despachantes, seguradoras e corretoras: conferência dos dados antes da proposta.

Locadoras e gestores de frota: registro e controle dos veículos.

Classificados, marketplaces e aplicativos: o anúncio completo a partir da placa.

Segurança e controle

A chave dá acesso ao seu saldo, por isso ela tem travas.

A chave aparece uma vez e só o resumo criptográfico fica guardado.

Criar uma chave pede um código de verificação do aplicativo autenticador ou do e-mail.

IPs permitidos, limite de gasto por dia, validade e revogação na hora.

Registro de cada pedido no painel, com a placa mascarada.

Webhooks assinados, só para endereço HTTPS público, sem dados pessoais no aviso.

Outros serviços da API

Tabela FIPE e consultas completas, pagas com o mesmo saldo e com a mesma chave.

Tabela FIPE

Preço FIPE

50 grátis por dia depois, R$ 0,02 por preço

Preço do mês escolhido e os dois meses anteriores, na mesma resposta.

Carros, motos e caminhões, 12.031 versões.

Busca de versões pelo nome, que tolera erro de digitação: grátis.

Consulta pelo código FIPE, com anos e combustíveis: grátis.

O mesmo preço no mesmo dia não conta de novo; sem preço para o mês, nada é cobrado.

Ver a tabela FIPE no site
Consultas completas

Relatórios do site

Mesmo preço do site pedido assíncrono, com webhook

Placa Dados O relatório mais completo pela placa R$ 14,97
Roubo e Furto Descubra se o veículo foi roubado R$ 7,72

O mesmo conteúdo do relatório no site.

Resposta na hora com o número do pedido; o resultado chega em segundos por webhook ou pela consulta do número.

Sem dados para a placa, o valor volta para o saldo.

O mesmo relatório pedido de novo em até 30 dias não é cobrado.

Ver o que cada relatório traz

Perguntas frequentes sobre a API

Quanto custa a API de consulta de placa?

As primeiras 20 consultas básicas da sua conta são grátis, como bônus de cadastro. Depois, cada consulta custa R$ 0,07. Se a sua conta consultar a mesma placa de novo em até 30 dias, custa R$ 0,05. Não há mensalidade, pacote nem valor mínimo: você paga só as consultas, com o saldo da conta.

A consulta é cobrada quando a placa não é encontrada?

Sim. Placa encontrada e placa sem cadastro são consultas concluídas e são cobradas. Se o serviço estiver fora do ar, a consulta não é concluída e nada é cobrado.

Posso testar a API sem pagar?

Sim. Toda conta ganha 20 consultas básicas grátis com placas reais, numa chave de produção; uma consulta que falha não gasta o bônus. Além disso, no painel você cria uma chave de teste, e as placas TST0001, TST0002 e TST0003 respondem sem custo em qualquer chave: encontrada, não encontrada e fora do ar.

Quais dados a API devolve?

A consulta básica devolve marca, modelo, versão, ano de fabricação, ano do modelo, cor, combustível, tipo, município, UF, se há registro de roubo ou furto, e o código e o valor FIPE. Os relatórios completos devolvem o mesmo conteúdo do relatório no site.

A API mostra dados do proprietário, chassi ou RENAVAM?

A consulta básica não traz dados pessoais, chassi, RENAVAM nem motor. Os relatórios que mostram esses dados no site, como o Placa Dados, mostram também pela API, para a finalidade que você declarar na ativação, como pede a LGPD.

Como coloco saldo para usar a API?

Pelo painel da sua conta, com PIX ou cartão. O mesmo saldo serve para o site e para a API.

Em que linguagem posso integrar?

Em qualquer uma que faça pedidos HTTPS e leia JSON. O painel traz exemplos em cURL, PHP, JavaScript e Python, um console de teste, o arquivo OpenAPI e uma SKILL para assistentes de IA escreverem a integração.

A API tem limite de uso?

Cada chave faz até 60 pedidos por minuto e cada conta até 120. Cada conta faz até 5 consultas básicas ao mesmo tempo e tem até 20 relatórios em andamento. Você pode definir um limite de gasto por dia e os IPs que podem usar cada chave. A API atende o Brasil e, de fora dele, as nuvens AWS, Google Cloud, Microsoft Azure e Oracle Cloud e os agentes de IA da OpenAI, Anthropic, Google e xAI; outro datacenter fora do Brasil precisa ter o IP na lista da chave.

A API tem a tabela FIPE?

Sim. Marcas, busca de versões pelo nome e consulta pelo código FIPE são grátis. O preço FIPE de um código e ano tem 50 consultas grátis por dia por conta; depois custa R$ 0,02 e já vem com os dois meses anteriores. Pedir o mesmo preço de novo no mesmo dia não conta de novo, e sem preço para o mês nada é cobrado.

Posso usar um agente de IA para integrar a API?

Sim. A SKILL da API, em https://consultadeplaca.net/desenvolvedores/skill.md, ensina os endpoints, os exemplos e as regras a qualquer agente, como Claude Code, Cursor, ChatGPT, Codex ou Gemini. Entregue o arquivo ao agente, guarde a chave na variável CDP_API_KEY e comece com a chave de teste.

Como funcionam os relatórios completos pela API?

Você pede o relatório e a API responde na hora com um número de pedido, já cobrando o preço do site. O resultado fica pronto em segundos e chega por webhook ou pela consulta do número. Se não houver dados para a placa, ou o serviço estiver fora do ar, o valor volta para o saldo. Se a sua conta já tem o mesmo relatório dos últimos 30 dias, o novo pedido não é cobrado.

O que é o webhook da API?

Um aviso automático que a API manda para o seu sistema quando um relatório fica pronto, quando o saldo é recarregado ou quando fica baixo. Cada aviso é assinado (padrão Standard Webhooks), vai só para endereço HTTPS e é tentado de novo por até 24 horas se o seu servidor estiver fora.

Comece com 20 consultas grátis

Crie a conta, ative a API e use as 20 consultas grátis do cadastro. A documentação completa fica no painel, depois do login.

Termos de uso da API