# 汽车车型库数据 API 接口

汽车车型库数据 API 接口

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

![gugudata api](https://static.gugudata.com/api_cover_vehicle_catalog_v2.png align="center")

## 1\. 产品功能

*   提供汽车品牌、车系、车型三级结构化数据，便于业务系统快速完成品牌到车型的级联查询；
    
*   支持品牌列表、品牌下车系列表、单个车系详情、车系下车型列表四类核心查询接口；
    
*   适合汽车资讯站、汽车报价页、选车工具、车型筛选器、线索表单、数据中台等业务场景；
    
*   接口字段精简，返回结构稳定，便于前端下拉选择、搜索推荐和后端数据关联；
    
*   支持标准分页参数 `pageIndex` 与 `pageSize`，便于 Web、App、管理后台统一集成；
    
*   提供在线数据预览和 demo 接口，方便接入前快速评估数据结构与展示效果；
    
*   全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
    
*   多节点部署，接口响应稳定，适合生产环境调用。
    
*   [接口调用状态与状态监控](https://www.gugudata.com/status)
    

# 2\. API 文档

**接口详情:** [https://www.gugudata.com/api/details/vehicle-catalog](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://www.gugudata.com/preview/vehicle-catalog)

**接口测试:** [https://api.gugudata.com/v1/vehicleBrands/demo?pageIndex=1&pageSize=10](https://api.gugudata.com/v1/vehicleBrands/demo?pageIndex=1&pageSize=10)

# 3\. 请求参数

| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | YOUR\_APPKEY | 付费后获取的 APPKEY |
| pageIndex | int | 否 | 1 | 页码，从 1 开始 |
| pageSize | int | 否 | 50 | 每页返回数量，最大值 100 |

# 4\. 返回参数

| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| 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

根据品牌唯一标识获取该品牌下的车系列表。

GET /v1/vehicleSeries

请求参数

| 参数名 | 参数类型 | 是否必须 | 备注 |
| --- | --- | --- | --- |
| brand\_id | string | 是 | 品牌唯一标识，由主接口返回 |
| appkey | string | 是 | APPKEY（查询参数） |
| pageIndex | int | 否 | 页码，从 1 开始 |
| pageSize | int | 否 | 每页返回数量，最大100 |

响应示例

```json
{
  "Items": [
    {
      "SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
      "BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
      "BrandName": "大众",
      "SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
      "SubBrandName": "大众(进口)",
      "SeriesName": "途锐"
    }
  ],
  "PageIndex": 1,
  "PageSize": 10,
  "TotalSize": 122
}
```

### 获取车系详情 GET /v1/vehicleSeries/{{seriesId}}

根据车系唯一标识获取单个车系详情。

GET /v1/vehicleSeries/{{seriesId}}

请求参数

| 参数名 | 参数类型 | 是否必须 | 备注 |
| --- | --- | --- | --- |
| seriesId | string | 是 | 车系唯一标识（路径参数） |
| appkey | string | 是 | APPKEY（查询参数） |

响应示例

```json
{
  "SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
  "BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
  "BrandName": "大众",
  "SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
  "SubBrandName": "大众(进口)",
  "SeriesName": "途锐"
}
```

### 获取车系下车型列表 GET /v1/vehicleTrims

根据车系唯一标识获取该车系下的车型列表。

GET /v1/vehicleTrims

请求参数

| 参数名 | 参数类型 | 是否必须 | 备注 |
| --- | --- | --- | --- |
| series\_id | string | 是 | 车系唯一标识，由车系接口返回 |
| appkey | string | 是 | APPKEY（查询参数） |
| pageIndex | int | 否 | 页码，从 1 开始 |
| pageSize | int | 否 | 每页返回数量，最大100 |

响应示例

```json
{
  "Items": [
    {
      "TrimId": "1d56d072e7d6ba79547b6ab32a50fab2",
      "SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
      "SeriesName": "途锐",
      "BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
      "SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
      "TrimName": "2.0TSI 锐尚版",
      "Year": 2023
    }
  ],
  "PageIndex": 1,
  "PageSize": 10,
  "TotalSize": 12
}
```