二手车估值 · ThinkAPI 统一API调用服务

## 二手车估值（停售） ![](https://img.kancloud.cn/e0/79/e079517b97af7e310ab5ff574fb72407_234x226.png) > 权威公正准确的全国二手车估值 ## 接口费用（ [点击购买](https://market.topthink.com/product/334)） > 最低 0.10元/次 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ## 接口1：全部品牌列表（免费）返回全部车辆品牌列表 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/brand ``` ### 请求参数无 ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | brandname | string | 品牌名称 | | id | int | 品牌id | | letter | string | 品牌首字母 | | picurl | string | 品牌logo | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarBrand() ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": [ { "brandname": "AC Schnitzer", "id": "153", "letter": "A", "picurl": "http://cheshangban.guguiche.com:89/static/unicdatapic/brand/153.jpg" }, { "brandname": "ALPINA", "id": "184", "letter": "A", "picurl": "http://cheshangban.guguiche.com:89/static/unicdatapic/brand/184.jpg" }, ... ] "code": 0 } ~~~ ## 接口2：指定品牌全部车系（免费）获取指定车牌的全部车系，包括：车系id、车系中文名称、制造厂商、车系 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/family ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | brandId | 是 | string | 车辆品牌ID | ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | brandname | string | 品牌名称 | | brandid | int | 品牌id | | id | int | 车系id | | familyname | string | 车系中文名称 | | factory | string | 制造厂商 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarFamily() ->withBrandId(17) ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": [ { "brandid": "17", "brandname": "本田", "factoryname": "广汽本田", "familyname": "奥德赛", "id": "117" }, { "brandid": "17", "brandname": "本田", "factoryname": "东风本田", "familyname": "思域", "id": "127" }, ... ] "code": 0 } ~~~ ## 接口3：指定车系具体车型列表（免费）获取指定车系的具体的车型列表,包括：年款、变速箱、排放标准、排放量、价格（万）等 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/model ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- |---| | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | familyId | 是 | string | 车系ID | ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | autohomeid | int | 车型id | | makeyear | string | 年款 | | geartype | string | 变速箱 | | emission | string | 排放标准 | | output | double | 排放量 | | price | double | 价格 | | brandid | int | 品牌id | | brandname | string | 品牌名称 | | factoryid | int | 厂商id | | factoryname | string | 厂商名称 | | familyid | int | 车系id | | familyname | string | 车系名称 | | salesdesc | string | 车型名称 | | saleyear | string | 该车型开始销售年份 | | salemonth | string | 该车型开始销售月份 | | stopyear | string | 该车型停产年份 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarModel() ->withFamilyId(2) ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": [ { "autohomeid": "27278", "brandid": "17", "brandname": "本田", "emission": "欧4", "factoryid": "30", "factoryname": "广汽本田", "familyid": "25", "familyname": "雅阁", "geartype": "自动", "makeyear": "2012", "max_reg_year": "2014", "min_reg_year": "2012", "output": "2", "price": "20.28", "salemonth": "1", "salesdesc": "2012款 2.0L 自动第八代雅阁 SE", "saleyear": "2012", "stopyear": "2014" }, ... ] "code": 0 } ~~~ ## 接口4：估值支持的省份（免费）获取支持估值的省份 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/province ``` ### 请求参数无 ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | id | int | 估值支持的省份的id | | name | string | 估值支持的省份的名称 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarProvince() ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": [ { "id": 1, "name": "北京市" }, { "id": 2, "name": "天津市" }, ... ] "code": 0 } ~~~ ## 接口5：估值支持的城市（免费）获取估值支持的城市 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/city ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | provinceId | 是 | string | 省份ID | ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | id | int | 城市的id | | name | string | 城市的名称 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarCity() ->withProvinceId(17) ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": [ { "id":258, "name":"武汉市" }, { "id":259, "name":"黄石市" }, { "id":260, "name":"十堰市" }, { "id":261, "name":"宜昌市" }, { "id":262, "name":"襄樊市" }, { "id":263, "name":"鄂州市" }, { "id":264, "name":"荆门市" }, { "id":265, "name":"孝感市" }, { "id":266, "name":"荆州市" }, { "id":267, "name":"黄冈市" }, { "id":268, "name":"咸宁市" }, { "id":269, "name":"随州市" }, { "id":270, "name":"恩施土家族苗族自治州" }, { "id":271, "name":"仙桃市" }, { "id":272, "name":"潜江市" }, { "id":273, "name":"天门市" }, { "id":274, "name":"神农架林区" } ] "code": 0 } ~~~ ## 接口6：二手车估值获取二手车估值信息 ### 请求地址 ``` GET https://api.topthink.com/secondhand_car/query ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | regDate | 是 | string | 上牌时间,格式：yyyy-MM ,燃油：(年款-2)~(年款+5) 混动：(年款-2)~(年款+3) 纯电：(年款-2)~(年款+2) | | city | 是 | int | 城市 | | provinceId | 是 | int | 省份id | | autoHomeId | 是 | int | 车型id | | miles | 是 | double | 行驶里程,单位：万公里 | ### 返回`data`参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | carPrice | json | 车辆估价 | | bad | json | 车况一般 | | good | json | 车况较好 | | normal | json | 车况优秀 | | C2C\_C2B | float | 车商收购价和个人交易价的中间值 | | C2B | float | 车商收购价 | | C2C | float | 个人和个人交易价 | | B2C\_C2C | float | 车商零售价和个人交易价的中间值 | | C2B\_min | float | 车商收购价的最小值 | | B2C | float | 车商零售价 | | B2C\_max | float | 车商零售价的最大值 | | city | string | 城市 | | regDate | string | 上牌时间 | | cityid | int | 城市id | | price | double | 出厂指导价 | | id | string | 车辆id | | provid | string | 省份id | | prov | string | 省份 | | mileage | string | 公里数 | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->secondhandCarQuery() ->withRegDate('2019-05') ->withCity(166) ->withProvinceId() ->withAutoHomeId() ->withMiles() ->request(); dump($result); ``` 返回数据示例： ~~~ { "message": "查询成功", "data": { "carPrice": { "bad": { "B2C": 15.47, "B2C_C2C": 15.17, "B2C_max": 16.24, "C2B": 14.46, "C2B_min": 14.03, "C2C": 15.06, "C2C_C2B": 14.79 }, "city": "苏州", "cityid": "166", "defaultprice": { "4S2C": 17.48, "4S2C_C2C": 17.14, "4S2C_max": 18.36, "B2C": 17.14, "B2C_C2C": 16.81, "B2C_max": 18, "C24S": 15.7, "C24S_min": 15.23, "C2B": 16.02, "C2B_min": 15.54, "C2C": 16.69, "C2C_C24S": 16.06, "C2C_C2B": 16.39 }, "good": { "B2C": 17.14, "B2C_C2C": 16.81, "B2C_max": 18, "C2B": 16.02, "C2B_min": 15.54, "C2C": 16.69, "C2C_C2B": 16.39 }, "id": "27251", "ly_code": "27251", "mileage": "2.02", "normal": { "B2C": 16.29, "B2C_C2C": 15.97, "B2C_max": 17.1, "C2B": 15.22, "C2B_min": 14.77, "C2C": 15.86, "C2C_C2B": 15.58 }, "price": "18.98", "prov": "江苏", "provid": "10", "regDate": "2018-12" } } "code": 0 } ~~~