汽车车型配置查询

正常 NEW

汽车车型配置查询，覆盖品牌/车系/车型/配置参数/对比。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1572次

¥ 0.004 / 次

按次计费

购买次数包更优惠，低至 0.0032 元/次

100次调用包 100 次调用 ¥0.0040 /次

500次调用包 500 次调用 ¥0.0038 /次省 5%

1000次调用包 1,000 次调用 ¥0.0036 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.0034 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0032 /次省 20%

健康检查

服务存活探测

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.version	string	数据版本
data.time	string	服务当前时间（UTC）
data.batch_limit	integer	批量查询允许的最大条数
data.compare_limit	integer	对比数量上限

请求示例

返回示例

{"msg":"success","code":200,"data":{"time":"2026-10-30 14:22:51","version":"1.0","batch_limit":10,"compare_limit":10}}

级别列表

返回车辆级别列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/levels JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].level	string	等级

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"level":"紧凑型SUV"},{"level":"中型SUV"},{"level":"紧凑型车"},{"level":"中型皮卡"},{"level":"微卡"},{"level":"轻客"},{"level":"中型车"},{"level":"中大型SUV"},{"level":"微面"},{"level":"中大型MPV"},{"level":"跑车"},{"level":"中大型车"},{"level":"小型SUV"},{"level":"微型车"},{"level":"小型车"},{"level":"紧凑型MPV"},{"level":"房车"},{"level":"全尺寸皮卡"},{"level":"轻卡"},{"level":"大型车"},{"level":"大型SUV"},{"level":"中型MPV"},{"level":"迷你皮卡"},{"level":"小型MPV"},{"level":"大型MPV"},{"level":"轿车"},{"level":"重型皮卡"},{"level":"UTV"},{"level":"皮卡"},{"level":"超重型皮卡"},{"level":"卡车"}],"total":31}}

能源类型列表

返回能源类型列表

返回能源类型列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/energies JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].energy_type	string	能源类型

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"energy_type":"汽油"},{"energy_type":"纯电动"},{"energy_type":"柴油"},{"energy_type":"插电式混合动力"},{"energy_type":"48V轻混系统"},{"energy_type":"油电混合"},{"energy_type":"增程式"},{"energy_type":"压缩天然气(CNG)"},{"energy_type":"油气混合"},{"energy_type":"未知"},{"energy_type":"醇电混合"},{"energy_type":"汽油电驱"},{"energy_type":"氢燃料电池"},{"energy_type":"24V轻混系统"},{"energy_type":"氢气"}],"total":15}}

品牌列表

返回汽车品牌列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/brands JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].manufacturer	string	厂商

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"manufacturer":"长安轻型车"},{"manufacturer":"奇瑞汽车"},{"manufacturer":"上汽大通"},{"manufacturer":"江铃汽车"},{"manufacturer":"上汽通用五菱"}],"total":5}}

车系列表

按关键词模糊查询车系列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/series JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	否	车系关键词，模糊匹配（LIKE），最大 128 字符；缺省返回全部车系
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].series	string	车系

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"series":"凯美瑞"},{"series":"KHANN凯美瑞"}],"total":2}}

车身结构列表

返回车身结构类型

返回合法车身结构列表（已过滤源数据错位值；无法识别的车型归入“其他”）。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/bodies JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].body_structure	string	车身结构

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"body_structure":"SUV"},{"body_structure":"三厢车"},{"body_structure":"皮卡"},{"body_structure":"微卡"},{"body_structure":"MPV"},{"body_structure":"两厢车"},{"body_structure":"客车"},{"body_structure":"货车"},{"body_structure":"其他"},{"body_structure":"硬顶跑车"},{"body_structure":"掀背车"},{"body_structure":"房车"},{"body_structure":"轿车"},{"body_structure":"轻卡"},{"body_structure":"轻客"},{"body_structure":"旅行车"},{"body_structure":"跑车"},{"body_structure":"软顶敞篷车"},{"body_structure":"微面"},{"body_structure":"硬顶敞篷车"}],"total":20}}

可查询字段列表

返回车型可查询字段

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/fields JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].field	string	字段名
data.list[].label	string	标签
data.list[].brief	boolean	是否属于精简字段

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"brief":true,"field":"id","label":"ID"},{"brief":true,"field":"series","label":"车系"},{"brief":true,"field":"model_name","label":"车型名称"},{"brief":true,"field":"price","label":"价格"},{"brief":false,"field":"price_guide","label":"官方指导价"},{"brief":true,"field":"manufacturer","label":"厂商"},{"brief":true,"field":"level","label":"级别"},{"brief":true,"field":"energy_type","label":"能源类型"},{"brief":true,"field":"market_time","label":"上市时间"},{"brief":true,"field":"engine","label":"发动机"},{"brief":false,"field":"max_power_kw","label":"最大功率(kW)"},{"brief":false,"field":"max_torque_nm","label":"最大扭矩(N·m)"},{"brief":true,"field":"transmission","label":"变速箱"},{"brief":false,"field":"dimensions","label":"长x宽x高(mm)"},{"brief":true,"field":"body_structure","label":"车身结构"},{"brief":false,"field":"max_speed","label":"最高车速(km/h)"},{"brief":false,"field":"acceleration_s","label":"官方百公里加速时间(s)"},{"brief":false,"field":"fuel_consumption","label":"WLTC综合油耗(L/100km)"},{"brief":false,"field":"power_consumption","label":"百公里耗电量(kWh/100km)"},{"brief":false,"field":"range_km","label":"等速续航里程(km)"},{"brief":false,"field":"warranty","label":"整车保修期限"},{"brief":false,"field":"maintenance_cost","label":"6万公里保养总成本预估"},{"brief":false,"field":"length_mm","label":"长(mm)"},{"brief":false,"field":"width_mm","label":"宽(mm)"},{"brief":false,"field":"height_mm","label":"高(mm)"},{"brief":false,"field":"wheelbase_mm","label":"轴距(mm)"},{"brief":false,"field":"doors","label":"车门数(个)"},{"brief":false,"field":"seats","label":"座位数(个)"},{"brief":false,"field":"curb_weight_kg","label":"整备质量(kg)"},{"brief":false,"field":"fuel_tank_l","label":"油箱容积(L)"},{"brief":false,"field":"battery_kwh","label":"电池容量(kWh)"}],"total":31}}

精确查询

按字段精确查询车型

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	查询关键词，最大 128 字符
match	string	否	匹配字段：auto / model_name / series / manufacturer，默认 auto
limit	integer	否	返回条数，默认 10，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式，仅返回核心字段
config	boolean	否	是否返回 config 配置 JSON
fields	string	否	返回字段白名单，仅空格分隔（如 id model_name；逗号不会被识别），单字段最大长度 64，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].series	string	车系
data.list[].model_name	string	车型名称
data.list[].price	string	价格
data.list[].price_guide	string	官方指导价
data.list[].manufacturer	string	厂商
data.list[].level	string	等级
data.list[].energy_type	string	能源类型
data.list[].market_time	string	上市时间
data.list[].engine	string	发动机
data.list[].max_power_kw	string	最大功率（千瓦）
data.list[].max_torque_nm	string	最大扭矩（牛·米）
data.list[].transmission	string	变速箱
data.list[].dimensions	string	车身尺寸
data.list[].body_structure	string	车身结构
data.list[].max_speed	string	最高车速
data.list[].acceleration_s	string	百公里加速时间（秒）
data.list[].fuel_consumption	string	综合油耗
data.list[].power_consumption	string	电耗
data.list[].range_km	string	续航里程（千米）
data.list[].warranty	string	质保信息
data.list[].maintenance_cost	string	保养费用
data.list[].length_mm	string	车长（毫米）
data.list[].width_mm	string	车宽（毫米）
data.list[].height_mm	string	车高（毫米）
data.list[].wheelbase_mm	string	轴距（毫米）
data.list[].doors	string	车门数
data.list[].seats	string	座位数
data.list[].curb_weight_kg	string	整备质量（千克）
data.list[].fuel_tank_l	string	油箱容积（升）
data.list[].battery_kwh	string	电池容量（千瓦时）
data.total	integer	总条数
data.mode	string	查询匹配模式

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4153,"model_name":"凯美瑞 2024款 2.0E 精英版"}],"mode":"exact","total":12}}

全文搜索

关键词搜索车型

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/search JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	搜索关键词，最大 128 字符；仅允许字母/数字/空白，其他字符视为空关键词；单字降级 LIKE
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理
level	string	否	过滤：级别（精确匹配）
energy_type	string	否	过滤：能源类型（精确匹配）
manufacturer	string	否	过滤：厂商（精确匹配）
body_structure	string	否	过滤：车身结构（精确匹配）
series	string	否	过滤：车系（精确匹配）
brief	boolean	否	精简模式，仅返回核心字段
config	boolean	否	是否返回 config 配置 JSON
fields	string	否	返回字段白名单，仅空格分隔（如 id model_name；逗号不会被识别），单字段最大长度 64，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].series	string	车系
data.list[].model_name	string	车型名称
data.list[].price	string	价格
data.list[].price_guide	string	官方指导价
data.list[].manufacturer	string	厂商
data.list[].level	string	等级
data.list[].energy_type	string	能源类型
data.list[].market_time	string	上市时间
data.list[].engine	string	发动机
data.list[].max_power_kw	string	最大功率（千瓦）
data.list[].max_torque_nm	string	最大扭矩（牛·米）
data.list[].transmission	string	变速箱
data.list[].dimensions	string	车身尺寸
data.list[].body_structure	string	车身结构
data.list[].max_speed	string	最高车速
data.list[].acceleration_s	string	百公里加速时间（秒）
data.list[].fuel_consumption	string	综合油耗
data.list[].power_consumption	string	电耗
data.list[].range_km	string	续航里程（千米）
data.list[].warranty	string	质保信息
data.list[].maintenance_cost	string	保养费用
data.list[].length_mm	string	车长（毫米）
data.list[].width_mm	string	车宽（毫米）
data.list[].height_mm	string	车高（毫米）
data.list[].wheelbase_mm	string	轴距（毫米）
data.list[].doors	string	车门数
data.list[].seats	string	座位数
data.list[].curb_weight_kg	string	整备质量（千克）
data.list[].fuel_tank_l	string	油箱容积（升）
data.list[].battery_kwh	string	电池容量（千瓦时）
data.list[].relevance	number	相关度评分（越大越相关）
data.total	integer	总条数
data.mode	string	查询匹配模式

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4772,"relevance":27.233306884765625,"model_name":"卡罗拉 2024款 1.5L CVT先锋版"}],"mode":"fulltext","total":9}}

分页列表

分页返回车型列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
page	integer	否	页码，>=1，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20，超出范围按边界值处理（优先于 limit）
limit	integer	否	每页条数，默认 20，最大 20，超出范围按边界值处理；仅在 page_size 缺省时生效
level	string	否	过滤：级别
energy_type	string	否	过滤：能源类型
manufacturer	string	否	过滤：厂商
body_structure	string	否	过滤：车身结构
series	string	否	过滤：车系
brief	boolean	否	精简模式，仅返回核心字段
config	boolean	否	是否返回 config 配置 JSON
fields	string	否	返回字段白名单，仅空格分隔（如 id model_name；逗号不会被识别），单字段最大长度 64，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].series	string	车系
data.list[].model_name	string	车型名称
data.list[].price	string	价格
data.list[].price_guide	string	官方指导价
data.list[].manufacturer	string	厂商
data.list[].level	string	等级
data.list[].energy_type	string	能源类型
data.list[].market_time	string	上市时间
data.list[].engine	string	发动机
data.list[].max_power_kw	string	最大功率（千瓦）
data.list[].max_torque_nm	string	最大扭矩（牛·米）
data.list[].transmission	string	变速箱
data.list[].dimensions	string	车身尺寸
data.list[].body_structure	string	车身结构
data.list[].max_speed	string	最高车速
data.list[].acceleration_s	string	百公里加速时间（秒）
data.list[].fuel_consumption	string	综合油耗
data.list[].power_consumption	string	电耗
data.list[].range_km	string	续航里程（千米）
data.list[].warranty	string	质保信息
data.list[].maintenance_cost	string	保养费用
data.list[].length_mm	string	车长（毫米）
data.list[].width_mm	string	车宽（毫米）
data.list[].height_mm	string	车高（毫米）
data.list[].wheelbase_mm	string	轴距（毫米）
data.list[].doors	string	车门数
data.list[].seats	string	座位数
data.list[].curb_weight_kg	string	整备质量（千克）
data.list[].fuel_tank_l	string	油箱容积（升）
data.list[].battery_kwh	string	电池容量（千瓦时）
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数
data.pages	integer	页数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4153,"model_name":"凯美瑞 2024款 2.0E 精英版"},{"id":4154,"model_name":"凯美瑞 2024款 2.0GVP 豪华版"},{"id":4155,"model_name":"凯美瑞 2024款 2.0G 尊贵版"},{"id":4156,"model_name":"凯美瑞 2024款 2.0S 运动版"}],"page":1,"pages":1,"total":4,"page_size":5}}

车型详情

按 ID 获取车型详情

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/detail JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
id	integer	是	车型 ID，必须 >0
brief	boolean	否	精简模式，仅返回核心字段
config	boolean	否	是否返回 config 配置 JSON，默认 true（与其他接口默认 false 不同）
fields	string	否	返回字段白名单，仅空格分隔（如 id model_name；逗号不会被识别），单字段最大长度 64，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.id	integer	唯一标识
data.series	string	车系
data.model_name	string	车型名称
data.price	string	价格
data.price_guide	string	官方指导价
data.manufacturer	string	厂商
data.level	string	等级
data.energy_type	string	能源类型
data.market_time	string	上市时间
data.engine	string	发动机
data.max_power_kw	string	最大功率（千瓦）
data.max_torque_nm	string	最大扭矩（牛·米）
data.transmission	string	变速箱
data.dimensions	string	车身尺寸
data.body_structure	string	车身结构
data.max_speed	string	最高车速
data.acceleration_s	string	百公里加速时间（秒）
data.fuel_consumption	string	综合油耗
data.power_consumption	string	电耗
data.range_km	string	续航里程（千米）
data.warranty	string	质保信息
data.maintenance_cost	string	保养费用
data.length_mm	string	车长（毫米）
data.width_mm	string	车宽（毫米）
data.height_mm	string	车高（毫米）
data.wheelbase_mm	string	轴距（毫米）
data.doors	string	车门数
data.seats	string	座位数
data.curb_weight_kg	string	整备质量（千克）
data.fuel_tank_l	string	油箱容积（升）
data.battery_kwh	string	电池容量（千瓦时）
data.config	object	配置信息
data.config.价格	string	车辆配置项「价格」
data.config.厂商	string	车辆配置项「厂商」
data.config.级别	string	车辆配置项「级别」
data.config.车型	string	车辆配置项「车型」
data.config.车身结构	string	车辆配置项「车身结构」
data.config.官方指导价	string	车辆配置项「官方指导价」

请求示例

返回示例

{"msg":"success","code":200,"data":{"id":1,"config":{"价格":"暂无报价","厂商":"广汽传祺","级别":"大型车","车型":"1 Concept 2025款 概念车","车身结构":"轿车","官方指导价":"暂无报价"},"model_name":"1 Concept 2025款 概念车"}}

批量查询

批量查询车型

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/car/batch JSON

请求参数

参数名	类型	必填	说明
items	array	是	查询项数组，最多 10 项，超出返回 4002；元素为车型 ID（key=id）或车型名称
key	string	否	查询键：id / model_name / series / manufacturer，默认 model_name。注意：参数名与认证密钥参数 key 同名，请使用 Authorization 请求头认证，勿用 URL 的 key 参数传递密钥
brief	boolean	否	精简模式，仅返回核心字段
config	boolean	否	是否返回 config 配置 JSON
fields	string	否	返回字段白名单，仅空格分隔（如 id model_name；逗号不会被识别），单字段最大长度 64，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ok	integer	成功处理的条目数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].doors	string	车门数
data.list[].level	string	等级
data.list[].price	string	价格
data.list[].seats	string	座位数
data.list[].engine	string	发动机
data.list[].series	string	车系
data.list[].range_km	string	续航里程（千米）
data.list[].warranty	string	质保信息
data.list[].width_mm	string	车宽（毫米）
data.list[].height_mm	string	车高（毫米）
data.list[].length_mm	string	车长（毫米）
data.list[].max_speed	string	最高车速
data.list[].dimensions	string	车身尺寸
data.list[].model_name	string	车型名称
data.list[].battery_kwh	string	电池容量（千瓦时）
data.list[].energy_type	string	能源类型
data.list[].fuel_tank_l	string	油箱容积（升）
data.list[].market_time	string	上市时间
data.list[].price_guide	string	官方指导价
data.list[].manufacturer	string	厂商
data.list[].max_power_kw	string	最大功率（千瓦）
data.list[].transmission	string	变速箱
data.list[].wheelbase_mm	string	轴距（毫米）
data.list[].max_torque_nm	string	最大扭矩（牛·米）
data.list[].acceleration_s	string	百公里加速时间（秒）
data.list[].body_structure	string	车身结构
data.list[].curb_weight_kg	string	整备质量（千克）
data.list[].fuel_consumption	string	综合油耗
data.list[].maintenance_cost	string	保养费用
data.list[].power_consumption	string	电耗
data.total	integer	总条数
data.returned	integer	本次实际返回条数
data.max_limit	integer	允许返回的最大条数
data.not_found	integer	未找到的记录数
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.list[].query	string	未命中的查询项（仅未命中时出现）
data.list[].error	string	错误标识：not_found（未命中）/ db_unavailable（数据库不可用）

请求示例

返回示例

{"msg":"success","code":200,"data":{"ok":2,"list":[{"id":1,"model_name":"1 Concept 2025款 概念车"},{"id":2,"model_name":"2002 Hommage 2016款 Pebble Beach Concept"}],"total":2,"returned":2,"max_limit":10,"not_found":0,"truncated":false}}

车型对比

对比多款车型参数

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/car/compare JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ids	string	是	车型 ID 列表，仅空格分隔的字符串（如 1 2 3；逗号会被当作单个值解析而失效），或数组形式 ids[]=1&ids[]=2；最多输入 10 个，超出直接报错（4002）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.returned	integer	本次实际返回条数
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.max_limit	integer	允许返回的最大条数
data.config_keys_count	integer	配置项数量
data.config_keys	array	配置项名称列表
data.config_keys[]	string	配置项名称
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].series	string	车系
data.list[].model_name	string	车型名称
data.list[].price	string	价格
data.list[].price_guide	string	官方指导价
data.list[].manufacturer	string	厂商
data.list[].level	string	等级
data.list[].energy_type	string	能源类型
data.list[].market_time	string	上市时间
data.list[].engine	string	发动机
data.list[].max_power_kw	string	最大功率（千瓦）
data.list[].max_torque_nm	string	最大扭矩（牛·米）
data.list[].transmission	string	变速箱
data.list[].dimensions	string	车身尺寸
data.list[].body_structure	string	车身结构
data.list[].max_speed	string	最高车速
data.list[].acceleration_s	string	百公里加速时间（秒）
data.list[].fuel_consumption	string	综合油耗
data.list[].power_consumption	string	电耗
data.list[].range_km	string	续航里程（千米）
data.list[].warranty	string	质保信息
data.list[].maintenance_cost	string	保养费用
data.list[].length_mm	string	车长（毫米）
data.list[].width_mm	string	车宽（毫米）
data.list[].height_mm	string	车高（毫米）
data.list[].wheelbase_mm	string	轴距（毫米）
data.list[].doors	string	车门数
data.list[].seats	string	座位数
data.list[].curb_weight_kg	string	整备质量（千克）
data.list[].fuel_tank_l	string	油箱容积（升）
data.list[].battery_kwh	string	电池容量（千瓦时）
data.list[].config	object	配置信息
data.list[].config.价格	string	车辆配置项「价格」
data.list[].config.厂商	string	车辆配置项「厂商」
data.list[].config.级别	string	车辆配置项「级别」
data.list[].config.车型	string	车辆配置项「车型」
data.list[].config.车身结构	string	车辆配置项「车身结构」
data.list[].config.官方指导价	string	车辆配置项「官方指导价」

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"doors":"","level":"大型车","price":"暂无报价","seats":"","config":{"价格":"暂无报价","厂商":"广汽传祺","级别":"大型车","车型":"1 Concept 2025款 概念车","车身结构":"轿车","官方指导价":"暂无报价"},"engine":"","series":"1Concept","range_km":"","warranty":"","width_mm":"","height_mm":"","length_mm":"","max_speed":"","dimensions":"","model_name":"1 Concept 2025款 概念车","battery_kwh":"","energy_type":"","fuel_tank_l":"","market_time":"","price_guide":"暂无报价","manufacturer":"广汽传祺","max_power_kw":"","transmission":"","wheelbase_mm":"","max_torque_nm":"","acceleration_s":"","body_structure":"轿车","curb_weight_kg":"","fuel_consumption":"","maintenance_cost":"","power_consumption":""},{"id":2,"doors":"2","level":"跑车","price":"暂无报价","seats":"4","config":{"价格":"暂无报价","厂商":"宝马(进口)","级别":"跑车","车型":"2002 Hommage 2016款 Pebble Beach Concept","宽(mm)":"1830","长(mm)":"4380","高(mm)":"1420","压缩比":"10.2","发动机":"3.0T 340马力 L6 直喷发动机 欧V","变速箱":"6挡手动","挡位数":"6","排量(L)":"3","排量(mL)":"2979","轴距(mm)":"2660","供油方式":"缸内直喷","燃料形式":"汽油","燃油标号":"95#","环保标准":"欧V","缸体材料":"铝合金","缸盖材料":"铝合金","能源类型":"汽油","车体结构":"承载式","车身结构":"硬顶跑车","转向类型":"电动助力","进气形式":"双涡轮增压","配气机构":"DOHC","驱动方式":"前置后驱","前轮距(mm)":"1541","后轮距(mm)":"1541","座位数(个)":"4","气缸数(个)":"6","车门数(个)":"2","前悬挂形式":"连杆支柱式独立悬挂","发动机型号":"N54B30TO","变速箱描述":"6挡手动","变速箱类型":"手动变速箱(MT)","后悬挂形式":"整体桥式非独立悬挂","官方指导价":"暂无报价","油箱容积(L)":"53","长x宽x高(mm)":"4380x1830x1420","整备质量(kg)":"1570","最大功率(kW)":"250","最大马力(Ps)":"340","最大扭矩(N·m)":"450","最高车速(km/h)":"250","气缸排列形式":"L","行李舱容积(L)":"370","车门开启方式":"平开门","每缸气门数(个)":"4","发动机特有技术":"Double VANOS","最大功率转速(rpm)":"5900","最大扭矩转速(rpm)":"1500-4500","官方百公里加速时间(s)":"4.9"},"engine":"3.0T 340马力 L6 直喷发动机 欧V","series":"2002Hommage","range_km":"1541","warranty":"","width_mm":"1830","height_mm":"1420","length_mm":"4380","max_speed":"250","dimensions":"4380x1830x1420","model_name":"2002 Hommage 2016款 Pebble Beach Concept","battery_kwh":"","energy_type":"汽油","fuel_tank_l":"53","market_time":"","price_guide":"暂无报价","manufacturer":"宝马(进口)","max_power_kw":"250","transmission":"6挡手动","wheelbase_mm":"2660","max_torque_nm":"450","acceleration_s":"4.9","body_structure":"硬顶跑车","curb_weight_kg":"1570","fuel_consumption":"","maintenance_cost":"","power_consumption":""},{"id":3,"doors":"2","level":"跑车","price":"暂无报价","seats":"2","config":{"价格":"暂无报价","厂商":"日产(进口)","级别":"跑车","车型":"2020 Vision Gran Turismo 2014款 2.5 两驱精英版","燃料形式":"汽油","能源类型":"汽油","车身结构":"硬顶跑车","座位数(个)":"2","车门数(个)":"2","官方指导价":"暂无报价"},"engine":"","series":"2020VisionGranTurismo","range_km":"","warranty":"","width_mm":"","height_mm":"","length_mm":"","max_speed":"","dimensions":"","model_name":"2020 Vision Gran Turismo 2014款 2.5 两驱精英版","battery_kwh":"","energy_type":"汽油","fuel_tank_l":"","market_time":"","price_guide":"暂无报价","manufacturer":"日产(进口)","max_power_kw":"","transmission":"","wheelbase_mm":"","max_torque_nm":"","acceleration_s":"","body_structure":"硬顶跑车","curb_weight_kg":"","fuel_consumption":"","maintenance_cost":"","power_consumption":""}],"total":3,"returned":3,"max_limit":10,"truncated":false,"config_keys":["价格","厂商","级别","车型","车身结构","官方指导价","宽(mm)","长(mm)","高(mm)","压缩比","发动机","变速箱","挡位数","排量(L)","排量(mL)","轴距(mm)","供油方式","燃料形式","燃油标号","环保标准","缸体材料","缸盖材料","能源类型","车体结构","转向类型","进气形式","配气机构","驱动方式","前轮距(mm)","后轮距(mm)","座位数(个)","气缸数(个)","车门数(个)","前悬挂形式","发动机型号","变速箱描述","变速箱类型","后悬挂形式","油箱容积(L)","长x宽x高(mm)","整备质量(kg)","最大功率(kW)","最大马力(Ps)","最大扭矩(N·m)","最高车速(km/h)","气缸排列形式","行李舱容积(L)","车门开启方式","每缸气门数(个)","发动机特有技术","最大功率转速(rpm)","最大扭矩转速(rpm)","官方百公里加速时间(s)"],"config_keys_count":53}}

产品说明

产品概述

汽车车型配置查询，覆盖品牌/车系/车型/配置参数/对比。

使用场景

数据查询：快速集成汽车车型配置查询到您的应用中

业务系统：将汽车车型配置查询数据嵌入业务流程

开发工具：通过 API 接口获取交通出行数据

数据分析：基于汽车车型配置查询数据进行分析和决策

费用计算

按次计费单价

¥0.004 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.4	¥0.0040/次	-	365 天
500次调用包	500 次	¥1.9	¥0.0038/次	省5%	365 天
1000次调用包	1000 次	¥3.6	¥0.0036/次	省10%	365 天
5000次调用包	5000 次	¥17	¥0.0034/次	省15%	365 天
10000次调用包	10000 次	¥32	¥0.0032/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.004/次
个人版	5000 次	5000 次	10%	¥0.0036/次
专业版	30000 次	30000 次	20%	¥0.0032/次
企业版推荐	200000 次	200000 次	30%	¥0.0028/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.004 × 1000 = ¥4.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.004 × (1 - 10%) × 1000 ≈ ¥3.60

示例3：购买「500次调用包」次数包

支付 ¥1.90，获得 500 次调用，折算单价 ¥0.0038/次

同等次数按次付费需 ¥2.00，次数包可节省 ¥0.10

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志