车型大全车系查询怎么用：按品牌名或 brandId 拉出全部车系
# 车型大全车系查询怎么用：按品牌名或 brandId 拉出全部车系
> 接口/接入点：车型大全（apiCode 1467）· 车系查询 1467-2 · 免费 · POST/GET · JSON · 适用人群：前端/全栈开发者 · 阅读时间：约 6 分钟
## 核心要点
- 车系查询（1467-2）两个入参 `brandName`、`brandId` 都选填，但建议用 `brandId`：品牌名可能有歧义，Id 是稳定主键。
- 返回 `data[]` 每个元素同时带 `series`/`series_id`（车系）与 `model`/`model_id`（车型），可直接渲染"车系—车型"两级文本。
- 拿到 `series_id` 后，配合 `brandId` 才能调车型详情（1467-3），这是三级联动的关键一环。
## Why
做车型选择器时，第二步就是"选了品牌之后，拉出这个品牌下有哪些车系和车型"。车系查询正好干这个，但 `brandName` 和 `brandId` 怎么选、返回里 `series` 和 `model` 到底差在哪，本文一次讲清。
## What
| 项 | 说明 |
|----|------|
| 接入点 | 车系查询 1467-2 |
| 请求地址 | https://route.showapi.com/1467-2?appKey=YOUR_APPKEY |
| 入参 | `brandName`（String，选填）、`brandId`（String，选填） |
| 必填 | 无（但至少传其一才能定位品牌；建议传 `brandId`） |
| 返回 | `data[]`: series, series_id, model, model_id, initial, brand_id, brand |
## How
### 用 brandId 查询（推荐）
```bash
curl -X POST "https://route.showapi.com/1467-2?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "brandId=59bf445f3909f3a96b69eb7e"
```
```python
import requests
APP_KEY = "YOUR_APPKEY"
r = requests.post("https://route.showapi.com/1467-2",
params={"appKey": APP_KEY, "brandId": "59bf445f3909f3a96b69eb7e"}, timeout=10)
body = r.json()["showapi_res_body"]
for item in body["data"][:5]:
print(item["series"], "=>", item["model"], "(series_id:", item["series_id"], ")")
```
### 用 brandName 查询（有歧义风险）
```bash
curl -X POST "https://route.showapi.com/1467-2?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "brandName=%E5%A5%A5%E8%BF%AA"
```
> `brandName` 为中文原文 URL 编码，示例中 `%E5%A5%A5%E8%BF%AA` 即"奥迪"。仅当没有 `brandId` 时才用，且要对返回做去重/校验。
## 返回示例与解析
```json
{
"showapi_res_body": {
"ret_code": "0",
"msg": "查询成功！",
"data": [
{"series":"一汽-大众奥迪","series_id":"59bf44603909f3a96b69eb80","model":"奥迪A3两厢","model_id":"59bf44603909f3a96b69eb81","initial":"A","brand_id":"59bf445f3909f3a96b69eb7e","brand":"奥迪"},
{"series":"一汽-大众奥迪","series_id":"59bf44603909f3a96b69eb80","model":"奥迪A4L","model_id":"59bf44613909f3a96b69eb83","initial":"A","brand_id":"59bf445f3909f3a96b69eb7e","brand":"奥迪"}
]
}
}
```
- `series`/`series_id`：车系（如"一汽-大众奥迪"），一个车系下有多个 `model`。
- `model`/`model_id`：车型（如"奥迪A3两厢"），是更细的层级。
- 注意同一 `series_id` 会出现在多行（每个 `model` 一行），前端展示时按 `series_id` 聚合。
## 进阶/边界
- 大品牌返回行数很多（一个车系一个 model 一行），初始化建库时按 `page`+`maxResults` 翻页拉全，运行时直接读本地表。
- 若只想要"车系列表"而非车型列表，按 `series_id` 去重即可。
- 拿到 `series_id` 后必须连同 `brandId` 调 1467-3，单独一个 `series_id` 无法查询详情。
## FAQ
**Q: brandName 和 brandId 必须都传吗？**
都不强制必填，但至少要传一个来定位品牌。推荐只传 `brandId`，更稳定。
**Q: 返回的 series 和 model 是什么关系？**
`series` 是车系（更粗），`model` 是车系下的具体车型（更细）；同一车系会以不同 `model` 多行出现。
**Q: 怎么拿到 series_id？**
从本接入点返回的 `series_id` 字段取；它也是车型详情 1467-3 的必填入参。
## 相关能力 / 下一步阅读
- [车型大全三级联动查询实战：品牌→车系→车型详情全链路设计](https://www.showapi.com/guides/car-model-chain-query-1467)
- [车型大全车型详情字段拆解：发动机/变速箱/底盘/安全配置怎么读](https://www.showapi.com/guides/car-model-detail-explain-1467)
- **本系列共 12 篇**：查看[车型大全 API 指南总目录](https://www.showapi.com/guides/car-model-guides-1467)
