二手车估值
最后更新于：2022-04-02 08:23:47
## 二手车估值（停售）
> 权威公正准确的全国二手车估值
## 接口费用（ [点击购买](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
}
~~~
';