二手车估价API怎么用:4个参数查车商收购价与零售价
二手车估价API怎么用?极速数据这个二手车估值接口只要车型ID、里程、上牌年月、城市四个参数,就返回新车价、零售价三档和车商收购价三档,每个字段还带纯数字版本。这篇把参数填法、返回字段、计次价格和错误码一次说清,也标出三个坑:confidence 不是 high 就别按平均价报价,示例代码里的参数名被符号吃掉照抄会报错,车况它压根不知道。想给回收系统加个自动报价,照着这篇接就行。
我们经常在做软件开发的时候,会遇到调用一些专业的数据,这个时候AI也帮不上忙,怎么办呢?必须要一些专业的数据接口。比如说我最近在开发二手车的时候,也就是二手车估值的时候,需要调用专业的数据,但是我也找不到这样的二手车估值API。
先说结论:它给的是区间,不是一口价
极速数据这个「二手车估价」接口,输入只要四样东西:车型ID、里程、上牌年月、城市。返回一串价格,分成两类——车商卖出去的零售价,和车商收车给你的收购价,每类还各给高、平均、低三档。
所以它回答的不是"这车值多少钱",而是"这车在这个城市、这个里程,大概落在什么价位区间"。这两句话差别挺大,后面会讲为什么。
接口地址是 https://api.jisuapi.com/carvaluation/evaluate,返回 JSON,GET 和 POST 都支持。
四个参数怎么填,卡点在车型ID
参数表里四项全标了必填,少一个直接报错。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| carid | string | 是 | 车型ID(车型大全接口的四级车型ID) |
| mileage | string | 是 | 里程(km) |
| regdate | string | 是 | 年月 |
| city | string | 是 | 城市 |
最容易卡住的是 carid。它不是车牌,也不是车架号,是车型大全接口里的四级车型ID。也就是说,想估一台 2023 款奔驰 C 260 L,得先调车型大全,把这台车对应的那个数字 ID 查出来,再拿来估价——这一步省不掉。
其余三个好办:里程填纯数字,单位公里,别写成"5万"这种带字的;上牌年月按年月格式,示例是 2023-07;城市直接用中文名,示例是「杭州」。
拼出来的请求长这样,把 yourappkey 换成你自己的 key就行:
https://api.jisuapi.com/carvaluation/evaluate?appkey=yourappkey&carid=164018&mileage=50000®date=2023-07&city=杭州
返回里真正要用的,就两组价
返回字段二十多个,实际要用的只有 price_retail_* 和 price_dealer_* 这两组。名字里的 good、average、poor 分别对应高、平均、低三档,每个还配一个 _yuan 结尾的纯数字版本,省得你自己去解析"万"。
拿文档里那台 2023 款奔驰 C 260 L 举例:5 万公里、2023 年 7 月上牌、杭州,新车价 26.7 万。三档摆在一起看:
| 档位 | 零售价(车商卖) | 车商收购价(收车) | 中间差 |
|---|---|---|---|
| 最高 | 19.28 万 | 16.38 万 | 2.89 万 |
| 平均 | 18.03 万 | 15.33 万 | 2.70 万 |
| 最低 | 17.91 万 | 15.22 万 | 2.69 万 |
中间那列差价是我最看重的:它告诉你车商从收进来再到卖出去之间有多少空间,差不多占零售价的一成半。自己收车报价的时候,这个数就是天花板——再往上顶,就得压库存周转来换,划不划算得自己算。
另外两个字段别忽略。一个是 confidence,信任度,三档 high / medium / low,示例这台车给的是 medium。
另一个是 newcar_price,新车价。有它就能顺手算保值率:18.03 除以 26.7,差不多 67.5%。这个数写进报价单,比干说一句"18 万"有说服力得多。
还有 brand、typename、carname、yeartype、fueltype、mileage、regdate、city 这一串,是回显字段,你传什么它回什么。别当废字段——顺手能当校验用,比如返回的 mileage 和你传的对不上,说明参数在传输路上被改过。
计次价格:从免费 10 次到 0.03 元一次
它按次计费,量越大单价越低。页面顶部标的"100 元 / 1000 次"就是 Level1,申请试用送 10 次,够把整条链路跑通两三遍。
| 套餐 | 规格 | 价格 | 折算 |
|---|---|---|---|
| 免费套餐 | 10 次 | 0 元 | 约 0 元 / 次 |
| Level1 | 1000 次 | 100 元 | 约 0.1 元 / 次 |
| Level2 | 10000 次 | 800 元 | 约 0.08 元 / 次 |
| Level3 | 50000 次 | 2500 元 | 约 0.05 元 / 次 |
| Level4 | 100000 次 | 3000 元 | 约 0.03 元 / 次 |
按真实业务量算一下:假设一个回收点一天报 20 台车,一个月 600 次,Level1 的 1000 次不到两个月就光了。一年按 7200 次算,正好落在 Level2 的 1 万次档,800 元——按档位标价是 0.08 元一次,实际用掉 7200 次摊下来约 0.11 元一次。这点钱跟人工翻行情比,基本可以忽略。
错误码里,这五个要单独处理
| 代号 | 说明 |
|---|---|
| 201 | 车型ID为空 |
| 202 | 车型ID错误 |
| 203 | 未找到该车型 |
| 204 | 里程数无效 |
| 205 | 可比车源不足,暂无法估价 |
101 到 108 那批是系统级的:APPKEY 空或过期、没这个数据的权限、超次数、IP 被禁或超限、接口维护中、接口已停用。这些属于账号和网络层面,统一按"调用失败,检查 key 或稍后重试"处理就行。
201 到 205 是业务层面的,含义完全不一样:203 是你那个车型ID 在库里没有,204 是里程填得不对,205 是这车可比车源太少、估不出来。这三个别一股脑弹"系统繁忙",该给用户一句人话。
三个容易踩的坑
坑一:confidence 低的时候,价格只能当参考
返回 status 等于 0,不代表这个价能用。confidence 是 low,或者压根没返回价格,说明样本不够。我给客户报价的习惯是:confidence 不是 high,就先按低档价说,别按平均价说。
坑二:示例代码里的参数名是坏的,别照抄
文档请求参数表里写的是 regdate,但下面 PHP、Java、Python、Node 四段示例代码里,这个参数全都显示成了 ®year=2023——® 被当成特殊符号吃掉了,后面的字也跟着错位。你要是直接复制那段代码去跑,参数名对不上,只能拿到 204 或者干脆报参数无效。
正确写法就一句:参数名用 regdate,值写 2023-07,跟上面那个请求示例保持一致。这个错看着小,头一次接的人容易白白多花半小时。
坑三:车况它根本不知道
参数表里只有车型、里程、上牌年月、城市四项。这车撞过没有、泡过水没有、保养记录怎么样,接口一概不知道。同一台车,事故车和精品车能差好几万,这个差价它不会替你扣。
所以它适合做初筛:一台车报进来,先用它出个区间,心里有个底;真正的成交价还得看车况。想把这套流程补全,页面「相关数据」里还有别的接口能接——VIN 查车五项、行驶证识别、车型大全,合起来就是"拍照识别行驶证 → 拿到车型ID → 估个价"的一条链路。
写在最后(我的看法)
这个接口最值钱的地方不是那个报价数字,是它把零售价和收购价分开给了。以前收车靠师傅的经验,现在至少有个可对照的区间,报价不会一开口就偏。
但它给的是市场区间,不是成交承诺。我自己的做法是三层:接口出区间,车况检测砍一刀,最后按当地库存和周转速度再调一次。三层走完,价格才敢发出去。
还有一句劝:别一上来就买最高档。先拿免费 10 次跑通,用手里几台已知成交价的车去对一对,看看它给的数跟你实际收车价差多少。差得太多,说明模型不认你所在的城市,这时候换接口比加量更划算。
最后提醒一下,价格表、免费额度和字段名这类东西,接口方随时可能调,接之前以官网页面为准。
本文参考自:极速数据《二手车估价API接口》