Integre a API de Valor de Mercado Estimado de Veículos em PHP Usando o Zyla API Hub (Guia)

Você precisa de avaliações de veículos em que possa confiar para fluxos de financiamento agora mesmo: calcular LTV, precificar garantias, preencher ofertas automaticamente e sinalizar outliers antes da subscrição. Ao final deste guia, você chamará a API de Valor de Mercado Estimado de Veículos no Zyla API Hub com um único VIN, analisará as estatísticas necessárias (média, distribuição, ajustes de quilometragem) e as integrará ao seu backend PHP—além de ver como consultar fabricantes e modelos e invocar a mesma API a partir de um agente de IA via MCP.

O que esta API faz e por que é importante para as finanças

A API de Valor de Mercado Estimado de Veículos retorna estimativas de preço de mercado para um veículo identificado pelo VIN, incluindo preço médio, desvio padrão, contagem de listagens comparáveis, uma distribuição de preços e ajustes baseados em quilometragem. Esses são exatamente os dados que você precisa para impulsionar fluxos de trabalho financeiros, como:

Ilustração: Integre a API de Valor de Mercado Estimado de Veículos em PHP Usando o Zyla API Hub (Guia)

Cálculos de LTV na originação de empréstimos e pré-aprovações automatizadas.
Monitoramento de garantias e pontuação de risco de portfólio.
Gerenciamento de ofertas (por exemplo, cotações de compra, trocas) com limites baseados em bandas de distribuição.
Detecção de fraudes/outliers comparando valores solicitados com a média de mercado e desvio padrão.

A API também expõe endpoints para descobrir fabricantes suportados e seus modelos, o que ajuda na validação quando você tem apenas um registro parcial.

Começando no Zyla API Hub

O Zyla API Hub é um marketplace com mais de 10.000 APIs públicas e um modelo de assinatura + cota em todas as listagens, então você usa uma conta e uma chave de API em todos os lugares. Para obter acesso:

Abra a página da API de Valor de Mercado Estimado de Veículos.
Clique em Inscrever-se (ou Começar Teste Gratuito quando disponível). Verifique a página da API para opções de acesso e preços atuais. O hub utiliza um modelo de assinatura + cota (não pago por chamada). Sem Plano Gratuito.
Copie sua chave de API e chame os endpoints com Authorization: Bearer YOUR_API_KEY.

Se você ainda não tem uma conta, crie uma aqui: Registrar. Você usará as mesmas credenciais em todo o marketplace e poderá gerenciar suas cotas a partir do seu painel.

Referência de endpoint que você realmente usará

Todos os endpoints abaixo requerem o cabeçalho de Autorização com sua chave e são GETs HTTPS padrão servidos pelo Zyla API Hub. Use as URLs e parâmetros exatos conforme mostrado.

1) Obter dados de preço do veículo

Método: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data
Descrição: Forneça um VIN e receba estatísticas e distribuição do valor de mercado estimado.

Parâmetro de consulta obrigatório:

vin (string): o VIN do veículo. Exemplo: 3FMTK3SU3NMA08229

Curl oficial:

curl -s -X GET "https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=3FMTK3SU3NMA08229" \
-H "Authorization: Bearer YOUR_API_KEY"

Exemplo de resposta JSON oficial:

{
"status": true,
"code": 200,
"data": {
"vin": "4T1DAACK7SU510354",
"success": true,
"id": "2025_toyota_camry_",
"vehicle": "2025 Toyota Camry ",
"mean": 34959.82,
"stdev": 3109,
"count": 26,
"mileage": 10166,
"certainty": 95,
"period": [
"2024-05-16",
"2024-07-26"
],
"prices": {
"average": 34959.82,
"below": 31849.83,
"above": 38069.81,
"distribution": [
{
"group": {
"min": 30867,
"max": 31428,
"count": 3
}
},
{
"group": {
"min": 31428,
"max": 32494,
"count": 3
}
},
{
"group": {
"min": 32494,
"max": 32603,
"count": 2
}
},
{
"group": {
"min": 32603,
"max": 32988,
"count": 3
}
},
{
"group": {
"min": 32988,
"max": 34189,
"count": 3
}
},
{
"group": {
"min": 34189,
"max": 34497,
"count": 2
}
},
{
"group": {
"min": 34497,
"max": 36988,
"count": 3
}
},
{
"group": {
"min": 36988,
"max": 38216,
"count": 2
}
},
{
"group": {
"min": 38216,
"max": 39842,
"count": 3
}
},
{
"group": {
"min": 39842,
"max": 41392,
"count": 2
}
}
]
},
"adjustments": {
"mileage": {
"average": 12015.69,
"input": 10166,
"adjustment": 80
}
}
},
"message": "Dados buscados com sucesso!"
}

O que usar em fluxos financeiros:

data.prices.average: base para o valor da garantia e LTV.
data.stdev e data.prices.distribution: definir buffers de risco e limites de outliers.
data.count: proxy de confiança (quantas listagens comparáveis estão por trás da estimativa).
data.adjustments.mileage.adjustment: reconciliar quilometragem específica com a média de quilometragem do mercado.
data.period: janela de tempo dos dados de mercado utilizados. As datas estão em formato ISO; nenhum fuso horário é especificado no exemplo.

A moeda não é especificada na resposta de exemplo. Trate os valores numéricos como quantidades sem unidade e alinhe o manuseio de moeda com o local do seu produto ou as notas da página da API. Evite suposições; em caso de dúvida, registre e exiba unidades claramente para os usuários internos.

2) Obter Fabricantes

Método: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4059/get-makers
Descrição: Recupere todos os fabricantes de veículos suportados.

Nenhum parâmetro de solicitação está documentado para este endpoint. Envie apenas o cabeçalho de Autorização.

Curl oficial:

3) Obter Modelos

Método: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4060/get-models
Descrição: Recupere todos os modelos relacionados a um fabricante específico.

Parâmetro de consulta obrigatório:

maker (string): nome do fabricante. Exemplo: audi

Curl oficial:

Integração PHP: buscar valor de mercado por VIN e calcular LTV

O seguinte trecho de PHP chama o endpoint “Obter dados de preço do veículo”, trata erros e usa o preço médio para calcular uma razão básica de Empréstimo-para-Valor. Você pode inserir isso em um controlador ou em um passo de trabalho em seu pipeline de financiamento.

<?php
$apiKey = 'YOUR_API_KEY';
$vin = '3FMTK3SU3NMA08229'; // Exemplo de VIN da documentação
$url = 'https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=' . urlencode($vin);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlErr = curl_error($ch);
curl_close($ch);

if ($curlErr) {
throw new RuntimeException('Erro cURL: ' . $curlErr);
}
if ($httpCode < 200 || $httpCode >= 300) {
throw new RuntimeException('Código de erro HTTP: ' . $httpCode . ' corpo=' . $response);
}

$payload = json_decode($response, true);
if (!isset($payload['status']) || $payload['status'] !== true) {
throw new RuntimeException('Status da API não OK: ' . $response);
}

// Extrair campos que você realmente precisa
data = $payload['data'] ?? [];
$mean = $data['mean'] ?? null;
$stdev = $data['stdev'] ?? null;
$count = $data['count'] ?? null;
mileageAdj = $data['adjustments']['mileage']['adjustment'] ?? 0;

// Exemplo: calcular um valor de garantia conservador aplicando um buffer (por exemplo, -0.5 stdev)
$bufferedValue = null;
if (is_numeric($mean) && is_numeric($stdev)) {
$bufferedValue = $mean - 0.5 * $stdev + $mileageAdj;
}

// Exemplo LTV: requested_loan / bufferedValue
$requestedLoan = 25000.00;
$ltv = null;
if ($bufferedValue && $bufferedValue > 0) {
$ltv = $requestedLoan / $bufferedValue;
}

// Saída ou armazenamento dos resultados
$result = [
'vin' => $data['vin'] ?? $vin,
'vehicle' => $data['vehicle'] ?? null,
'mean' => $mean,
'stdev' => $stdev,
'count' => $count,
'mileage_adjustment' => $mileageAdj,
'buffered_value' => $bufferedValue,
'requested_loan' => $requestedLoan,
'ltv' => $ltv
];

header('Content-Type: application/json');
echo json_encode($result, JSON_PRETTY_PRINT);

Exemplo em JavaScript (Node.js ou ambientes modernos)

Este exemplo chama o mesmo endpoint usando fetch e registra campos-chave usados na lógica de financiamento.

import fetch from 'node-fetch';

const API_KEY = 'YOUR_API_KEY';
const VIN = '3FMTK3SU3NMA08229';

const url = `https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=${encodeURIComponent(VIN)}`;

const res = await fetch(url, {
method: 'GET',
headers: {
'Authorization': `Bearer ${API_KEY}`
}
});

if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status} - ${text}`);
}

const payload = await res.json();
if (!payload.status) {
throw new Error('A API relatou status não-sucedido');
}

const data = payload.data || {};
const mean = data.mean;
const stdev = data.stdev;
const count = data.count;
const avgMileage = data.adjustments?.mileage?.average;
const inputMileage = data.adjustments?.mileage?.input;
const mileageAdj = data.adjustments?.mileage?.adjustment;

console.log({
vin: data.vin,
vehicle: data.vehicle,
mean,
stdev,
count,
period: data.period,
averagePrice: data.prices?.average,
lowBand: data.prices?.below,
highBand: data.prices?.above,
distributionBuckets: data.prices?.distribution?.length,
mileage: { avgMileage, inputMileage, mileageAdj }
});

Usando fabricantes e modelos para validar entradas

Quando você não tem um VIN, mas ainda deseja pré-validar uma submissão de cliente (por exemplo, dropdowns de fabricante/modelo em um formulário de financiamento), use os endpoints de descoberta.

Obter Fabricantes: retorna fabricantes suportados. Nenhum parâmetro está documentado; chame apenas com o cabeçalho de Autorização.
Obter Modelos: requer fabricante. Por exemplo: maker=audi.

Essas chamadas leves ajudam você a reduzir entradas inválidas antes de tentar a avaliação e minimizar logs de subscrição ruidosos.

Detalhes operacionais que economizam seu tempo

Autenticação: cada solicitação usa Authorization: Bearer YOUR_API_KEY.
Semântica HTTP: todos os endpoints documentados são GET. Trate-os como idempotentes e seguros; você pode tentar novamente em falhas transitórias.
Cotas e faturamento: o Zyla API Hub usa assinatura + cota, não pago por chamada. Verifique a página da API para opções de acesso e preços atuais. Para uso inicial no hub, você normalmente verá um teste de 7 dias ou 50 solicitações disponíveis para começar; confirme na listagem.
Cache: avaliações de VIN não são geralmente em tempo real como cotações; considere armazenar em cache por VIN por um período razoável. A resposta inclui um array de período indicando a janela de dados de mercado que informou a estimativa.
Moeda e unidades: o exemplo mostra valores de preço numéricos sem uma moeda explícita; mantenha suas representações internas cientes da moeda e exiba unidades claramente em qualquer interface. Valores de quilometragem são numéricos; não assuma uma unidade a menos que confirmada nas especificações do seu produto.
Tratamento de erros: inspecione códigos de status HTTP e o booleano de nível superior "status". Registre a "mensagem" para observabilidade quando presente.
Grupos de distribuição: esses suportam subscrição baseada em percentis (por exemplo, exigir que o empréstimo solicitado não exceda a banda alta ou o percentil 75). Os grupos são fornecidos como intervalos min/max com contagens.

Implemente um fluxo de financiamento com os campos de resposta

Aqui está um portão LTV prático que você pode implementar imediatamente usando campos do endpoint de avaliação:

Chame Obter dados de preço do veículo com o VIN do solicitante.
Calcule um valor de garantia conservador usando prices.average menos uma fração de stdev, mais ajuste de quilometragem se presente.
Calcule LTV = requested_loan / conservative_value.
Aprovação automática se LTV estiver abaixo do seu limite; caso contrário, encaminhe para revisão manual e exiba grupos de distribuição para que um analista possa julgar outliers.

A presença de contagem e certeza ajuda você a decidir se o tamanho da amostra ou a confiança justificam uma investigação adicional antes de emitir crédito.

Chame a API de agentes de IA via MCP

Se você usar ferramentas compatíveis com MCP (Claude Code, Cursor, Windsurf, etc.), pode permitir que um agente acesse esta API sem precisar codificar HTTP sob medida. Direcione seu cliente para o endpoint MCP em MCP usando sua chave de API Zyla (https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY). Dentro de uma sessão MCP, use as ferramentas fornecidas para descobrir a listagem (por exemplo, via uma ferramenta get_api_info referenciando o id da listagem 3623) e então invoque a operação alvo (por exemplo, call_api para o endpoint Obter dados de preço do veículo id 4058 com o parâmetro vin). Isso mantém o tempo de execução do agente sem estado e permite que você reutilize as mesmas credenciais Zyla em várias tarefas.

Lista de verificação de testes

Use o curl oficial uma vez para validar seu cabeçalho de Autorização e caminho de rede.
Registre o JSON bruto durante o desenvolvimento para verificar campos antes de mapear para objetos de domínio.
Assegure-se de que sua matemática de financiamento trate campos nulos ou ausentes de forma graciosa (por exemplo, se ajustes estiverem ausentes).
Armazene em cache por VIN para reduzir chamadas repetidas na mesma sessão de subscrição.
Registre sempre o array de período junto com a avaliação armazenada em seu registro de decisão.

Links úteis

API de Valor de Mercado Estimado de Veículos no Zyla API Hub
Zyla API Hub — explore mais de 10.000 APIs públicas com uma única conta e chave

FAQ

1) Qual é o mínimo que preciso para chamar o endpoint de avaliação?
Somente o VIN como parâmetro de consulta e o cabeçalho Authorization: Bearer YOUR_API_KEY.

2) Posso procurar fabricantes e modelos sem um VIN?
Sim. Use Obter Fabricantes (sem parâmetros documentados) e Obter Modelos com o parâmetro de consulta de fabricante (por exemplo, maker=audi) para construir ou validar entradas de formulário.

3) Como devo interpretar prices.average vs. mean?
No exemplo, prices.average e mean compartilham o mesmo valor numérico. Use mean para matemática central e combine com stdev e distribuição para implementar buffers conservadores para decisões de financiamento.

4) Os valores de preço estão atrelados a uma moeda?
A resposta de exemplo não especifica moeda. Trate-os como quantidades numéricas e alinhe com o contexto de moeda do seu sistema. Para saídas voltadas ao cliente, rotule claramente a moeda de acordo com as especificações do seu produto.

5) Quais são os fundamentos de acesso e faturamento?
O Zyla API Hub usa um modelo de assinatura + cota (não pago por chamada). Para uso inicial no hub, você normalmente verá um teste de 7 dias ou 50 solicitações para começar; sempre verifique a página da API para opções de acesso e preços atuais. Sem Plano Gratuito.

Pronto para integrar isso ao seu stack de subscrição? Crie sua conta, obtenha uma chave de API e implemente a integração: Registrar. Você pode explorar e se inscrever na API de Valor de Mercado Estimado de Veículos e continuar expandindo com outras listagens no Zyla API Hub usando a mesma chave.