二手车估价API准确度：这4个参数填准了，priceStart与priceEnd才靠谱- 惊觉

二手车估价API准确度：这4个参数填准了，priceStart与priceEnd才靠谱

接口结论：usedcar.price（二手车价格评估），POST https://api.xujian.tech/openapi/usedcar/price，请求头 X-API-Key + Content-Type: application/json 鉴权。JSON 请求体 20 个字段全部可选，但 brand 与 model 至少填一个，单个字段 ≤ 50 字符；返回评估价格区间 priceStart（下限，万元，可作快速成交 / 收车参考价）与 priceEnd（上限，万元，可作零售挂牌参考价），外加 tip 结果说明。按次计费 0.50 元/次，估不出价格不计费。

同一个接口，有人评估出来的区间很贴市价，有人觉得「偏高了」——差别通常不在接口，而在参数质量。估值的权重高度集中在四个字段上，把它们填准，区间就靠谱；乱填，区间就飘。

联系与账户问题：api.xujian.tech 控制台，或 Vxujian_cq

决定估值质量的 4 个参数（按权重排序）

优先级	字段	示例	为什么重要
1	`mileage`	8.5	行驶里程，权重最高，单位万公里
2	`registrationDate` + `year`	2022-03 / 2023	上牌时间决定车龄折旧，年款决定车型定位
3	`location`	北京	车辆所在地，地域价差真实存在
4	`accidentHistory`	0	事故历史：0 无事故 / 1 轻微剐蹭 / 2 更换覆盖件 / 3 结构损伤

这四项务必尽量填准；其余字段（configuration、transferCount、maintenanceRecord、fuelType、transmissionType、displacement、color、vin、engineModel、emissionStandard、underWarranty、vehicleUsage、description）可选，但填得越全结果越稳。

两个价格分别怎么用

priceStart（下限）：快速成交 / 收车参考价。收车方按它出价，留出整备与利润空间。
priceEnd（上限）：零售挂牌参考价。挂牌高于它基本没有询盘。
返回的是区间而不是单一数字：真实交易永远存在议价空间，把区间展示给用户比给一个假精确的「标准价」更诚实。
tip 为固定提示「估计信息来源网络内容，仅供参考」，对外展示时保留，避免把估值当定价依据。

调用示例

curl -s -X POST "https://api.xujian.tech/openapi/usedcar/price" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: 你的APIKey" \
  -d '{
    "brand": "大众",
    "model": "迈腾",
    "year": "2023",
    "configuration": "330TSI DSG 豪华型",
    "registrationDate": "2022-03",
    "mileage": "8.5",
    "accidentHistory": "0",
    "transferCount": "0",
    "maintenanceRecord": "全程4S店保养",
    "fuelType": "汽油",
    "transmissionType": "自动",
    "displacement": "2.0",
    "color": "黑色",
    "location": "北京"
  }'

{
  "code": 0,
  "msg": "success",
  "data": {
    "priceStart": 12.5,
    "priceEnd": 14.8,
    "tip": "估计信息来源网络内容，仅供参考",
    "apiCode": "usedcar.price",
    "apiName": "二手车价格评估",
    "chargeType": "PER_CALL",
    "balance": 99.5000,
    "costMs": 1200
  }
}

Python：

import requests

def estimate(api_key: str, car: dict):
    """评估二手车价格区间；估不出返回 None 且不扣费"""
    resp = requests.post(
        "https://api.xujian.tech/openapi/usedcar/price",
        json=car,
        headers={"Content-Type": "application/json", "X-API-Key": api_key},
        timeout=30,
    )
    result = resp.json()
    if result.get("code") != 0:
        print("评估失败（不收费）：", result.get("msg"))
        return None
    data = result["data"]
    return data["priceStart"], data["priceEnd"]

if __name__ == "__main__":
    car = {
        "brand": "大众", "model": "迈腾", "year": "2023",
        "registrationDate": "2022-03", "mileage": "8.5",
        "accidentHistory": "0", "transferCount": "0", "location": "北京",
    }
    print("评估区间（万元）：", estimate("你的APIKey", car))

常见问题（FAQ）

usedcar.price 多少钱一次？ PER_CALL 按次计费，0.50 元/次；brand 与 model 都没填、字段超 50 字符、估不出价格区间、上游超时、余额不足均不计费。

20 个字段必须全填吗？ 不必，全部可选；但 brand 与 model 至少一个，且 mileage / registrationDate（或 year）/ location / accidentHistory 这四项的质量直接决定区间准不准。

评估的是哪辆车？ 是「品牌 + 车龄 + 里程 + 车况 + 地域」组合下的典型车，不是某辆具体车——具体车辆的车况请结合 detail 接口的实际数据一起看。

能不能只传 vin？ vin 只是可选辅助字段，不参与「至少填一个」的判定，brand / model 仍需至少填一个。

计费口径备忘

计费类型：PER_CALL（按次计费），单价 0.50 元/次。
不计费场景：brand 与 model 均为空；任一字段超过 50 字符；未能评估出价格区间；上游超时或网络异常；鉴权失败；二手车服务未启用；余额不足。
响应 balance 为扣费后余额，交易流水可逐笔核对。

接入建议

从 detail 回填参数最省事：对库内车源估价时，用 usedcar.detail 的车名与车况字段拼 brand / model / mileage / location，避免人工录入引入误差。
失败先补参再重试：「未能评估出价格区间」不计费，按提示补品牌、型号、上牌时间与里程后重试即可，不要原样连点。
表单入口做长度校验：50 字符上限在前端拦住，省掉注定失败的请求。
估值结果落库带时间戳：行情随时间变动，评估结果只代表调用时点，展示时标注评估日期。

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/xujianflying/article/details/170547923

二手车估价API准确度：这4个参数填准了，priceStart与priceEnd才靠谱