二手車估值 · 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 } ~~~