汽车车型库数据 API 接口

Parry
0 阅读4分钟

汽车车型库数据 API 接口

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

gugudata api

1. 产品功能

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

2. API 文档

接口详情: www.gugudata.com/api/details…

接口地址: api.gugudata.com/v1/vehicleB…

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: api.gugudata.com/v1/vehicleB…

数据预览: www.gugudata.com/preview/veh…

接口测试: api.gugudata.com/v1/vehicleB…

3. 请求参数

参数名参数类型是否必须默认值备注
appkeystring是YOUR_APPKEY付费后获取的 APPKEY
pageIndexint否1页码，从 1 开始
pageSizeint否50每页返回数量，最大值 100

4. 返回参数

参数名参数类型备注
DataStatus.StatusCodeint接口返回状态码，100 为成功
DataStatus.StatusDescriptionstring接口返回状态说明
DataStatus.ResponseDateTimestring接口数据返回时间
DataStatus.DataTotalCountint当前查询条件下的总品牌数量
Data.Items[]array品牌列表
Data.Items[].BrandIdstring品牌唯一标识
Data.Items[].BrandNamestring品牌名称
Data.PageIndexint当前页码
Data.PageSizeint当前每页数量
Data.TotalSizeint品牌总数

相关接口

获取品牌下车系列表 GET /v1/vehicleSeries

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

GET /v1/vehicleSeries

请求参数

参数名参数类型是否必须备注
brand_idstring是品牌唯一标识，由主接口返回
appkeystring是APPKEY（查询参数）
pageIndexint否页码，从 1 开始
pageSizeint否每页返回数量，最大100

响应示例

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

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

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

GET /v1/vehicleSeries/{{seriesId}}

请求参数

参数名参数类型是否必须备注
seriesIdstring是车系唯一标识（路径参数）
appkeystring是APPKEY（查询参数）

响应示例

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

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

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

GET /v1/vehicleTrims

请求参数

参数名参数类型是否必须备注
series_idstring是车系唯一标识，由车系接口返回
appkeystring是APPKEY（查询参数）
pageIndexint否页码，从 1 开始
pageSizeint否每页返回数量，最大100

响应示例

{
  "Items": [
    {
      "TrimId": "1d56d072e7d6ba79547b6ab32a50fab2",
      "SeriesId": "1967e411adcb0634b7cd5c51a079bb93",
      "SeriesName": "途锐",
      "BrandId": "95b5e5f7fe82e8caef6805ee5a56afde",
      "SubBrandId": "f4e553fa9e5942dc077ed51d9c51aae4",
      "TrimName": "2.0TSI 锐尚版",
      "Year": 2023
    }
  ],
  "PageIndex": 1,
  "PageSize": 10,
  "TotalSize": 12
}
avatar
文章
阅读
粉丝