代码编程 分享

二手车估价API怎么用:4个参数查车商收购价与零售价

杨同学
杨同学 会员组
2026-11-10 12:03 32 阅读 0 评论

二手车估价API怎么用?极速数据这个二手车估值接口只要车型ID、里程、上牌年月、城市四个参数,就返回新车价、零售价三档和车商收购价三档,每个字段还带纯数字版本。这篇把参数填法、返回字段、计次价格和错误码一次说清,也标出三个坑:confidence 不是 high 就别按平均价报价,示例代码里的参数名被符号吃掉照抄会报错,车况它压根不知道。想给回收系统加个自动报价,照着这篇接就行。

我们经常在做软件开发的时候,会遇到调用一些专业的数据,这个时候AI也帮不上忙,怎么办呢?必须要一些专业的数据接口。比如说我最近在开发二手车的时候,也就是二手车估值的时候,需要调用专业的数据,但是我也找不到这样的二手车估值API。

先说结论:它给的是区间,不是一口价

极速数据这个「二手车估价」接口,输入只要四样东西:车型ID、里程、上牌年月、城市。返回一串价格,分成两类——车商卖出去的零售价,和车商收车给你的收购价,每类还各给高、平均、低三档。

所以它回答的不是"这车值多少钱",而是"这车在这个城市、这个里程,大概落在什么价位区间"。这两句话差别挺大,后面会讲为什么。

接口地址是 https://api.jisuapi.com/carvaluation/evaluate,返回 JSON,GET 和 POST 都支持。

四个参数怎么填,卡点在车型ID

参数表里四项全标了必填,少一个直接报错。

参数类型必填说明
caridstring是车型ID(车型大全接口的四级车型ID)
mileagestring是里程(km)
regdatestring是年月
citystring是城市

最容易卡住的是 carid。它不是车牌,也不是车架号,是车型大全接口里的四级车型ID。也就是说,想估一台 2023 款奔驰 C 260 L,得先调车型大全,把这台车对应的那个数字 ID 查出来,再拿来估价——这一步省不掉。

其余三个好办:里程填纯数字,单位公里,别写成"5万"这种带字的;上牌年月按年月格式,示例是 2023-07;城市直接用中文名,示例是「杭州」。

拼出来的请求长这样,把 yourappkey 换成你自己的 key就行:

https://api.jisuapi.com/carvaluation/evaluate?appkey=yourappkey&carid=164018&mileage=50000&regdate=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 元 / 次
Level11000 次100 元约 0.1 元 / 次
Level210000 次800 元约 0.08 元 / 次
Level350000 次2500 元约 0.05 元 / 次
Level4100000 次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——&reg 被当成特殊符号吃掉了,后面的字也跟着错位。你要是直接复制那段代码去跑,参数名对不上,只能拿到 204 或者干脆报参数无效。

正确写法就一句:参数名用 regdate,值写 2023-07,跟上面那个请求示例保持一致。这个错看着小,头一次接的人容易白白多花半小时。

坑三:车况它根本不知道

参数表里只有车型、里程、上牌年月、城市四项。这车撞过没有、泡过水没有、保养记录怎么样,接口一概不知道。同一台车,事故车和精品车能差好几万,这个差价它不会替你扣。

所以它适合做初筛:一台车报进来,先用它出个区间,心里有个底;真正的成交价还得看车况。想把这套流程补全,页面「相关数据」里还有别的接口能接——VIN 查车五项、行驶证识别、车型大全,合起来就是"拍照识别行驶证 → 拿到车型ID → 估个价"的一条链路。

写在最后(我的看法)

这个接口最值钱的地方不是那个报价数字,是它把零售价和收购价分开给了。以前收车靠师傅的经验,现在至少有个可对照的区间,报价不会一开口就偏。

但它给的是市场区间,不是成交承诺。我自己的做法是三层:接口出区间,车况检测砍一刀,最后按当地库存和周转速度再调一次。三层走完,价格才敢发出去。

还有一句劝:别一上来就买最高档。先拿免费 10 次跑通,用手里几台已知成交价的车去对一对,看看它给的数跟你实际收车价差多少。差得太多,说明模型不认你所在的城市,这时候换接口比加量更划算。

最后提醒一下,价格表、免费额度和字段名这类东西,接口方随时可能调,接之前以官网页面为准。

本文参考自:极速数据《二手车估价API接口》

评论 0 请文明发言,共建良好生态

验证码
这篇笔记还没有评论,快来抢沙发吧~