历年高考高校招生计划
GET
https://api.gugudata.com/metadata/college-enrollment-plan
GET /metadata/college-enrollment-plan业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY。 |
| year | query | string | 是 | 无 | 查询年份。当前可选值：2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| pageIndex | query | integer | 是 | 无 | 分页页码，从 1 开始。 |
| pageSize | query | integer | 是 | 无 | 每页数量，取值范围为 1~100。 |
| classone | query | string | 否 | 专业门类/一级分类筛选。当前全部可选值（共 33 项）：--、交通运输大类、公共管理与服务大类、公安与司法大类、农学、农林牧渔大类、医学、医药卫生大类、历史学、哲学、土木建筑大类、工学、教育与体育大类、教育学、文化艺术大类、文学、新闻传播大类、旅游大类、水利大类、法学、理学、生物与化工大类、电子与信息大类、管理学、经济学、能源动力与材料大类、艺术学、装备制造大类、财经商贸大类、资源环境与安全大类、轻工纺织大类、食品药品与粮食大类、交叉学科。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高校招生计划数据-查询参数枚举（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.classone。 | |
| classtwo | query | string | 否 | 专业类/二级分类筛选。当前全部可选值（共 181 项）：--、中医学类、中医药类、中国语言文学类、中药学类、中西医结合类、临床医学类、交通运输类、仪器类、体育学类、体育类、健康管理与促进类、公共事业类、公共卫生与卫生管理类、公共卫生与预防医学类、公共服务类、公共管理类、公安学类、公安技术类、兵器类、农业工程类、农业类、农业经济管理类、力学类、动物医学类、动物生产类、化学类、化工与制药类、化工技术类、医学技术类、历史学类、口腔医学类、司法技术类、哲学类、图书情报与档案管理类、土建施工类、土木类、地球物理学类、地理科学类、地质学类、地质类、城乡规划与管理类、城市轨道交通类、基础医学类、外国语言文学类、大气科学类、天文学类、安全科学与工程类、安全类、安全防范类、工业工程类、工商管理类、市政工程类、广播影视类、康复治疗类、建筑类、建筑设备类、建筑设计类、建设工程管理类、心理学类、戏剧与影视学类、护理学类、护理类、政治学类、教育学类、教育类、数学类、文化服务类、文秘类、新闻传播学类、新闻出版类、旅游管理类、旅游类、有色金属材料类、机械类、机械设计制造类、材料类、林业工程类、林业类、林学类、核工程类、植物生产类、民族学类、水上运输类、水产类、水利工程与管理类、水利类、汽车制造类、法医学类、法学类、法律实务类、法律执行类、测绘地理信息类、测绘类、海洋工程类、海洋科学类、物流管理与工程类、物流类、物理学类、环境保护类、环境科学与工程类、生物医学工程类、生物工程类、生物技术类、生物科学类、电力技术类、电子信息类、电子商务类、电气类、畜牧业类、眼视光类、矿业类、社会学类、管理科学与工程类、纺织服装类、纺织类、经济与贸易类、经济学类、经济贸易类、统计学类、统计类、美术学类、能源动力类、自动化类、自然保护与环境生态类、航空航天类、航空装备类、航空运输类、船舶与海洋工程装备类、艺术学理论类、艺术设计类、草学类、药品与医疗器械类、药学类、表演艺术类、计算机类、设计学类、语言类、财务会计类、财政学类、财政税务类、资源勘查类、轻工类、通信类、道路运输类、邮政类、金融学类、金融类、铁道运输类、集成电路类、音乐与舞蹈学类、食品科学与工程类、食品类、马克思主义理论类、交叉工程类、侦查类、公安管理类、包装类、印刷类、房地产类、新能源发电工程类、机电设备类、热能与发电工程类、石油与天然气类、轨道装备类、非金属材料类、餐饮类、黑色金属材料类、建筑材料类、民族文化艺术类、气象类、水土保持与水环境类、渔业类、煤炭类、粮食类、轻化工类、金属与非金属矿类、水文水资源类、水利水电设备类、管道运输类、交叉学科。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高校招生计划数据-查询参数枚举（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.classtwo。 | |
| batchName | query | string | 否 | 录取批次筛选。当前全部可选值（共 117 项）：一本预科、专科批、专科批F段、专科提前批、专科提前批E段、专项计划本科、国家专项批、国家专项计划(本一)、国家专项计划(本二)、国家专项计划提前批(本一)、国家专项计划本科批、提前一批本科、提前专项批、提前二批本科、提前批、提前批A段、提前批B段、提前本科批、普通类一段、普通类二段、普通类平行录取、普通类提前批、本科一批、本科一批A1段、本科一批A段、本科一批B段、本科一段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二批、本科二批A段、本科二批B段、本科二批C段、本科二批及预科、本科二段、本科批、本科批A段、本科批B段、本科批C段、本科批（民委专项）、本科提前批、本科提前批A段、本科提前批B段、本科提前批C段、艺术类专科批、艺术类本科批、零志愿批次、高校专项批、高校专项计划批次、高校专项计划本一批、高校专项计划本科批、专科提前批A段、专科提前批B段、专科特殊类型批次K段、体育类本科提前批B段、国家专项计划提前批(本二)、艺术类本科提前批B段、本科提前批C、艺术类本科提前批C段、国家专项计划批、国家及地方专项、南疆单列、对口援疆计划本科一批次、体育类本科批、公安司法军士类专科批次N段、国家优师专项、地方专项计划本科批、体育类专科批、提前二批高职(专科)、国家及地方专项、南疆单列、对口援疆计划本科二批次、体育类本科提前批、艺术类本科提前批、高职高专提前批、平行录取二段、乡村振兴专项计划、区域教育均衡发展专项、地方专项计划、省级公费师范生、高校专项计划提前批、平行录取一段、提前一批高职(专科)、国家及地方专项、南疆单列、对口援疆计划本科一批、提前录取本科一批、提前批A类、提前批B类、提前批艺体类本科、本科批A段（国家专项）、本科批（特殊类型）、本科批（高校专项）、本科提前批-国家专项、本科提前批D段、本科提前批（国家专项）、本科预科班批、民航飞行技术批、特殊类型批、特殊类型招生批、综合评价批、高校专项计划批、高校农村专项计划、高职专科提前批、高职专科提前批E段、提前录取本科二批、地方农村专项计划批次、综合评价批次、定向计划批、提前批艺体类专科、地方专项计划批、地方农村专项计划、专科提前批C段、提前录取军校批、区域专项计划批、本科批A段（地方专项）、本科批（区域教育均衡发展专项）、本科批（原加授少数民族语文）、本科批（原少数民族语言授课为主）、本科批（预科）、本科提前批-高校专项、本科提前批（高校专项）。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高校招生计划数据-查询参数枚举（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.batchName。 | |
| type | query | string | 否 | 科类/选科类型筛选。当前全部可选值（共 15 项）：历史类、文科、物理类、理科、综合、艺术文、艺术类、体育类（历史）、体育类（物理）、艺术类（历史）、艺术类（物理）、体育类、体育文、体育理、艺术理。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高校招生计划数据-查询参数枚举（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.type。 | |
| schoolname | query | string | 否 | 高校名称关键词；与 schooluuid 同时传入时需同时满足相应筛选条件。 | |
| provincename | query | string | 否 | 招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。 | |
| collegemajorname | query | string | 否 | 招生专业名称关键词；可与高校、年份、招生省份、科 类和批次条件组合筛选。 | |
| schooluuid | query | string | 否 | 高校唯一标识，适合与高校基础数据、分数线接口进行关联。 | |
| dataUpdatedForm | query | string | 否 | 原有数据更新时间下界条件；保留历史参数拼写，留空不筛选。 | |
| minTuition | query | number | 否 | 无 | 最低学费筛选，单位通常为元/学年；为空时不筛选。 |
| maxTuition | query | number | 否 | 无 | 最高学费筛选，单位通常为元/学年；为空时不筛选。 |
独立请求示例
{
"year": 2025,
"schoolname": "北京大学",
"provincename": "江苏",
"type": "物理类",
"pageIndex": 1,
"pageSize": 3
}返回契约
application/json{
"type": "object",
"properties": {
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"nullable": true,
"description": "招生计划明细唯一标识。"
},
"InSchoolYears": {
"type": "string",
"nullable": true,
"description": "该招生专业的学制说明，按原文展示。"
},
"ClassOne": {
"type": "string",
"nullable": true,
"description": "专业门类/一级分类。"
},
"ClassTwo": {
"type": "string",
"nullable": true,
"description": "专业类/二级分类。"
},
"BatchName": {
"type": "string",
"nullable": true,
"description": "录取批次名称。"
},
"Type": {
"type": "string",
"nullable": true,
"description": "招生科类/选科类型。"
},
"SchoolName": {
"type": "string",
"nullable": true,
"description": "高校名称。"
},
"RecruitCode": {
"type": "string",
"nullable": true,
"description": "院校招生代码，按招生年份、省份、批次、科类及招生单元区分；同一高校可能有多个代码。空值表示当前未能确认对应代码。"
},
"EnrollmentNumbers": {
"type": "string",
"nullable": true,
"description": "该条招生计划的计划人数；按年份、招生省份、专业及批次等条件理解，不是实际录取人数。"
},
"SchoolUUID": {
"type": "string",
"nullable": true,
"description": "高校唯一标识。"
},
"CourseSelectionRequirements": {
"type": "string",
"nullable": true,
"description": "该招生计划的选科要求；空值表示尚未确认，不代表不限选科。"
},
"CollegeMajorName": {
"type": "string",
"nullable": true,
"description": "招生计划中的专业名称与说明。"
},
"ShortCollegeMajorName": {
"type": "string",
"nullable": true,
"description": "专业名称短名称。"
},
"CollegeMajorCode": {
"type": "string",
"nullable": true,
"description": "该招生专业对应的国标专业代码资料；与 LocalMajorCode 的本地报考代码区分使用。"
},
"LocalMajorCode": {
"type": "string",
"nullable": true,
"description": "对应招生目录中的本地专业代码（填报志愿使用），不等同于 CollegeMajorCode 国标专业代码。空值表示当前未能确认，不可用其他年份或国标代码代填。"
},
"Tuition": {
"type": "string",
"nullable": true,
"description": "该条计划的学费说明，通常按元／年计；遇到文字说明时保留原文，不视为空值或零学费。"
},
"Year": {
"type": "string",
"nullable": true,
"description": "招生年份。"
},
"ProvinceName": {
"type": "string",
"nullable": true,
"description": "招生计划面向的考生省份，不是高校所在地。"
},
"SpecialGroup": {
"type": "string",
"nullable": true,
"description": "适用专业组模式时返回的源数据组标识，不是填报志愿使用的专业组号。重庆返回空值；空值也可能表示未确认。"
},
"SpecialCode": {
"type": "string",
"nullable": true,
"description": "源数据中的专业标识，不可替代 LocalMajorCode 本地报考专业代码。"
},
"SpecialGroupName": {
"type": "string",
"nullable": true,
"description": "适用专业组模式时返回的专业组名称，例如（101）。重庆返回空值，选科要求请读取 CourseSelectionRequirements；空值不代表不限选科。"
},
"major_category": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "解析的专业分类结果。"
},
"included_majors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "解析出的包含专业列表。"
},
"description": "解析出的包含专业列表。"
},
"campus": {
"type": "string",
"nullable": true,
"description": "解析出的校区信息。"
},
"special_requirements": {
"type": "string",
"nullable": true,
"description": "解析出的特殊要求。"
}
},
"required": [
"DataId",
"InSchoolYears",
"ClassOne",
"ClassTwo",
"BatchName",
"Type",
"SchoolName",
"RecruitCode",
"EnrollmentNumbers",
"SchoolUUID",
"CourseSelectionRequirements",
"CollegeMajorName",
"ShortCollegeMajorName",
"CollegeMajorCode",
"LocalMajorCode",
"Tuition",
"Year",
"ProvinceName",
"SpecialGroup",
"SpecialCode",
"SpecialGroupName",
"major_category",
"included_majors",
"campus",
"special_requirements"
],
"description": "当前计划数组，嵌套类型详见 responseSchema。"
},
"description": "当前计划数组，嵌套类型详见 responseSchema。"
},
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
}
},
"required": [
"Data",
"DataStatus"
]
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
},
"Data": {
"type": "null",
"description": "当前计划数组，嵌套类型详见 responseSchema。"
}
}
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
},
"Data": {
"type": "null",
"description": "当前计划数组，嵌套类型详见 responseSchema。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 400 |
| 900 | 依赖失败 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13