Vehicle Market Value API – Pricing by VIN & Mileage

Get an algorithmic vehicle market value range from a VIN (17 chars) and optional mileage. Returns average value, below/above range, confidence score, and valuation breakdown in USD.

原始信息汇总

Vehicle Market Value API – Pricing by VIN & Mileage 数据集概述

基本信息

• 数据集名称: Vehicle Market Value API – Pricing by VIN & Mileage
• 提供者: VinData
• 类别: Transportation
• 订阅计划:
  • BASIC: $0.00 / mo
  • PRO: $9.99 / mo
  • ULTRA: $79.99 / mo
  • MEGA: $549.99 / mo

API 概述

通过车辆识别码（VIN，17位字符）和可选的里程数，获取算法生成的车辆市场价值范围。返回平均价值、低于/高于范围的价值、置信度分数以及以美元计价的估值明细。

目标用户

适用场景

• 车辆市场平台，用于在列表上显示预估价格范围。
• 经销商/库存工具，需要通过VIN快速估值。
• 潜在客户表单，希望在深入评估前获得报价区间。
• 分析仪表板，用于比较估计价值与要价。
• 需要具有明确明细的置信度评分定价的应用程序。

不适用场景

• 车主查询、注册数据、留置权/所有权检查或个人数据。
• 针对每种配置/车况场景的“保证准确”定价。
• 实时经销商报价、拍卖结果或专有市场数据源。
• 基于车况的评估（事故、维修、磨损），未作为输入提供。
• 缺失/无效的VIN（必须恰好为17个字符）。

端点

• 方法: GET
• 路径: /vehicle/market-value
• 功能: 使用提供的VIN和可选里程数返回车辆市场价值范围，包括置信度评分、分布和透明的估值明细。

请求与响应

输入要求

• VIN: 必需，必须恰好为17个字符。
• Mileage: 可选。如果提供，将作为估值模型的一部分应用。

响应示例（成功）

响应包含以下主要部分：

• meta: 元数据，包括请求ID、状态、估值类型、置信度分数、货币、精度、舍入方式和截止日期。
• vehicle: 车辆信息，包括年份、品牌、型号、配置、车身类型、车辆类别、细分市场和细分市场显示名称。
• marketValue: 市场价值数据，包括平均值、低于平均值、高于平均值、标准差以及价值分布直方图。
• confidence: 置信度信息，包括级别、解释和影响因素。
• valuationFactors: 估值因素列表。
• inputs: 输入和计算明细，包括基础新车价格、车龄、预期里程、提供里程、里程差、折旧价值、里程调整、最终价值等。
• error: 错误信息，成功时为null。

错误响应示例

错误时，error 字段包含错误代码和消息，例如 "VIN_INVALID" 和 "VIN must be exactly 17 characters."。其他主要数据字段（如 vehicle, marketValue）为null。

核心特点

• 基于范围的输出: 提供低于/平均/高于范围的价值，适合实际定价用户体验。
• 置信度评分与解释: 允许对估计值进行门控或标记。
• 透明的明细: 通过输入和估值因素提供透明的计算过程。
• 稳定的结构化模式: 专为生产环境集成设计。
• 可扫描的分布直方图: 适用于分析和定价用户界面。

订阅者信息

• 订阅者数量: 2

搜集汇总

背景与挑战

背景概述

该API通过17位VIN码和可选里程数参数，提供车辆市场价值范围算法评估服务，返回包括平均值、价值区间、置信度评分及美元计价的详细估值分析。