API v1 — Producao

Ofertas de assinatura
ao vivo

Busque ofertas, compare empresas, simule custos e integre tudo ao seu sistema via API.

—
Ofertas Ativas
—
Empresas
—
Marcas
12
Endpoints
Marketplace

Busca de Ofertas

Busca completa com 15+ filtros. Clique para testar ao vivo.

01Buscar Ofertas de AssinaturaGET▾
https://trocadecarro.com.br/v1/marketplace?type=subscription&sort=price_asc

Retorna preco mensal, empresa, veiculo, cobertura, score TKDC, cores e mais.

ParametroTipoDescricao
qstringBusca livre — ex: T-Cross, Compass
company_idUUIDFiltrar por empresa
price_min / price_maxdecimalFaixa de preco mensal
statestringCobertura — SP, RJ, MG...
brand_id / model_id / version_idUUIDFiltrar por veiculo
score_minintScore minimo TKDC (0-100)
color_group_keystringCor — branco, prata...
sortstringprice_asc, price_desc, newest, score_desc
page / sizeintPaginacao (max 100)
02Marcas com Ofertas AtivasGET▾
https://trocadecarro.com.br/v1/marketplace/brands

Retorna somente marcas que possuem ofertas ativas, com logo e codigo FIPE.

03Cores Disponiveis por VersaoGET▾
https://trocadecarro.com.br/v1/marketplace/color-groups?version_id=...&company_id=...

Variantes de cor para uma combinacao versao + empresa. Retorna grupo, cores especificas, menor preco e quantidade.

04Detalhe de uma OfertaGET▾
https://trocadecarro.com.br/v1/marketplace/{offer_id}

Todos os dados de uma oferta especifica: preco, prazo, KM, empresa, veiculo, cobertura, fotos.

Empresas

Empresas de Assinatura

Detalhes operacionais completos: seguro, KM, contrato, manutencao, assistencia.

05Listar EmpresasGET▾
https://trocadecarro.com.br/v1/subscription-entities?has_offers=true

Lista empresas ativas. Com has_offers=true retorna somente as que possuem ofertas ativas.

06Detalhe Completo da Empresa (+40 campos)GET▾
https://trocadecarro.com.br/v1/subscription-entities/{slug}

Retorna: seguro (franquias roubo/colisao, terceiros, vidros), contrato (reajuste, multa, pagamento), KM (cobranca, acumulo, medicao), manutencao (pneu, freio, suspensao, corretiva), assistencia (guincho, chaveiro, combustivel), cobertura, carro reserva, aceite PF/PJ e mais.

Comparativo

Assinatura vs Compra vs Financiamento

Custo real em 3 cenarios, com breakdown completo de custos.

07Pricing Summary por ModeloGET▾
https://trocadecarro.com.br/v1/carros/{marca}/{modelo}/pricing-summary?state=SP&ownership_months=36

Para cada versao: assinatura (melhor oferta, empresa, prazo), compra a vista (depreciacao + IPVA + seguro + manutencao) e financiamento (entrada + parcelas + juros).

08Simulador TCO — Defaults por VersaoGET▾
https://trocadecarro.com.br/v1/calculator/vehicle-defaults/{version_id}?state=SP&ownership_months=36

Dados pre-calculados: FIPE, aquisicao, IPVA, seguro, custo/km, depreciacao (curva historica), financiamento, equipamentos por categoria.

09Taxas por Estado (IPVA + Licenciamento)GET▾
https://trocadecarro.com.br/v1/calculator/states

IPVA (normal, eletrico, hibrido), licenciamento e emplacamento dos 27 estados.

10Historico FIPEGET▾
https://trocadecarro.com.br/v1/versions/{version_id}/fipe-history

Evolucao mensal do preco FIPE. Essencial para calcular depreciacao real.

11Comparador de VersoesGET▾
https://trocadecarro.com.br/v1/calculator/compare?ids=uuid1,uuid2

Compara ate 4 versoes: specs, equipamentos e precos lado a lado.

12Inflacao IPCAGET▾
https://trocadecarro.com.br/v1/calculator/inflation?from_date=2024-01-01&to_date=2026-03-01

Correcao inflacionaria entre duas datas.

Integracao

Como usar

curl -H "X-API-Key: SUA_CHAVE" \ "https://trocadecarro.com.br/v1/marketplace?type=subscription&q=T-Cross"

Formato: JSON REST • Auth: Header X-API-Key • Paginacao: page + size (max 100) • Compativel: N8N, Make, Zapier, Python, Node.js

Planos

Monte seu plano sob medida

Base fixa de R$ 1.497/mes (inclui 1K requests). Comece por um preset:

API de Dados — Requests /mes 25.000
Inclui 1.000 requests/mes. Acima disso, R$ 5,00 por 1.000 requests extras.
⚡ 10 req/min  •  100 req/dia — Rate limit proporcional ao volume contratado
Modulos da API
Ative os modulos extras conforme sua necessidade. Os 3 modulos base estao sempre inclusos:
✓
Marketplace incluso
Busca de ofertas de assinatura com 15+ filtros (marca, modelo, preco, estado, cor, score TKDC). Retorna preco mensal, empresa, prazo, KM, cobertura geografica.
Ex: GET /v1/marketplace?type=subscription&q=T-Cross&state=SP&sort=price_asc
✓
Marcas com Ofertas incluso
Lista de marcas que possuem ofertas ativas no marketplace, com logo e codigo FIPE.
Ex: GET /v1/marketplace/brands
✓
Segmentos de Mercado incluso
Categorias de veiculos (SUV, Sedan, Hatch, Eletrico, AWD...) com quantidade de modelos e faixa de preco por segmento.
Ex: GET /v1/segments?category=body
Modulos extras
Ficha tecnica completa: motor, potencia, torque, consumo, dimensoes. Lista de equipamentos por categoria (seguranca, conforto, multimidia).
Ex: GET /v1/carros/volkswagen-vw/volkswagen-vw-t-cross/200tsi-10-turbo-at-2026
Preco FIPE atual e evolucao mensal. Essencial para calcular depreciacao real e projetar valor de revenda.
Ex: GET /v1/versions/{id}/fipe-history
Custo total de propriedade (compra vs financiamento vs assinatura), comparador lado a lado de versoes (specs + equipamentos), taxas por estado (IPVA, licenciamento).
Ex: GET /v1/calculator/compare?ids=uuid1,uuid2 Ex: GET /v1/carros/{marca}/{modelo}/pricing-summary?state=SP
Assistente IA WhatsApp — Respostas /mes 0
Inclui 100 respostas/mes. Acima disso, R$ 0,40 por resposta da IA.
Bot inteligente no numero WhatsApp da sua empresa. Atende 24h, busca veiculos, compara precos, recomenda com base no perfil do cliente. Memoria de contexto inclusa (24h).
✓
Busca inteligente — "Quero um SUV ate 2 mil por mes" → IA encontra as melhores opcoes
✓
Comparativos — "Qual a diferenca entre T-Cross e Compass?" → dados reais lado a lado
✓
Recomendador personalizado — IA sugere veiculos com base em perfil, orcamento, familia e uso
✓
Memoria de contexto — Cliente volta no dia seguinte, IA lembra a conversa anterior
✓
Numero proprio — IA responde no WhatsApp da sua empresa, co-branded
MCP Tools — Calls /mes 0
Inclui 1.000 calls/mes. Acima disso, R$ 5,00 por 1.000 calls extras.
Conecte nossos 133 tools ao Claude, ChatGPT ou qualquer agente IA da sua empresa. Sua IA ganha superpoderes automotivos: buscar veiculos, calcular TCO, comparar versoes, consultar FIPE — tudo via protocolo MCP padrao.
✓
Plug & play — Adicione ao Claude Desktop ou qualquer client MCP em minutos
✓
133 ferramentas — Catalogo, CRM, estrategia, marketplace, garagem, financeiro
✓
Controle granular — Escolha quais tools cada usuario pode acessar
Resumo mensal
Base da plataformaR$ 1.497
API RequestsR$ 62
Endpoints extrasR$ 0
IA WhatsAppR$ 800
MCP ToolsR$ 0
TotalR$ 1.359
Sem fidelidade. Cancele quando quiser.
Interesse

Quer acesso a esta API?

Deixe seu WhatsApp e entraremos em contato com os planos disponiveis.