汽车车型库数据 API 接口
汽车数据 / 车型库 / 品牌库 / 车系库 / 车型数据 / 新车数据 API / 汽车品牌查询 / 车系查询 / 车型查询

pageIndex 与 pageSize,便于 Web 、App 、管理后台统一集成;接口详情: https://www.gugudata.com/api/details/vehicle-catalog
接口地址: https://api.gugudata.com/v1/vehicleBrands
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/v1/vehicleBrands?appkey=YOUR_APPKEY&pageIndex=1&pageSize=10
数据预览: https://www.gugudata.com/preview/vehicle-catalog
接口测试: https://api.gugudata.com/v1/vehicleBrands/demo?pageIndex=1&pageSize=10
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| pageIndex | int | 否 | 1 | 页码,从 1 开始 |
| pageSize | int | 否 | 50 | 每页返回数量,最大值 100 |
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码,100 为成功 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 当前查询条件下的总品牌数量 |
| Data.Items[] | array | 品牌列表 |
| Data.Items[].BrandId | string | 品牌唯一标识 |
| Data.Items[].BrandName | string | 品牌名称 |
| Data.PageIndex | int | 当前页码 |
| Data.PageSize | int | 当前每页数量 |
| Data.TotalSize | int | 品牌总数 |
根据品牌唯一标识获取该品牌下的车系列表。
GET /v1/vehicleSeries
请求参数
| 参数名 | 参数类型 | 是否必须 | 备注 |
|---|---|---|---|
| brand_id | string | 是 | 品牌唯一标识,由主接口返回 |
| appkey | string | 是 | APPKEY (查询参数) |
| pageIndex | int | 否 | 页码,从 1 开始 |
| pageSize | int | 否 | 每页返回数量,最大 100 |
响应示例
{
"Items": [
{
"SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
"BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
"BrandName": "大众",
"SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
"SubBrandName": "大众(进口)",
"SeriesName": "途锐"
}
],
"PageIndex": 1,
"PageSize": 10,
"TotalSize": 122
}
根据车系唯一标识获取单个车系详情。
GET /v1/vehicleSeries/{{seriesId}}
请求参数
| 参数名 | 参数类型 | 是否必须 | 备注 |
|---|---|---|---|
| seriesId | string | 是 | 车系唯一标识(路径参数) |
| appkey | string | 是 | APPKEY (查询参数) |
响应示例
{
"SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
"BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
"BrandName": "大众",
"SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
"SubBrandName": "大众(进口)",
"SeriesName": "途锐"
}
根据车系唯一标识获取该车系下的车型列表。
GET /v1/vehicleTrims
请求参数
| 参数名 | 参数类型 | 是否必须 | 备注 |
|---|---|---|---|
| series_id | string | 是 | 车系唯一标识,由车系接口返回 |
| appkey | string | 是 | APPKEY (查询参数) |
| pageIndex | int | 否 | 页码,从 1 开始 |
| pageSize | int | 否 | 每页返回数量,最大 100 |
响应示例
{
"Items": [
{
"TrimId": "1d56d072e7d6ba79547b6ab32a50fab2",
"SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
"SeriesName": "途锐",
"BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
"SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
"TrimName": "2.0TSI 锐尚版",
"Year": 2023
}
],
"PageIndex": 1,
"PageSize": 10,
"TotalSize": 12
}