汽车车型库数据 API 接口

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

1. 产品功能

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

2. API 文档

接口详情: 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

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
}