历年高考专业录取分数线
GET
https://api.gugudata.com/metadata/ceemajorline
GET /metadata/ceemajorline业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| pageindex | query | integer | 是 | 无 | 分页参数，第几页 |
| pagesize | query | integer | 是 | 无 | 分页参数，每页总条数，取值范围在 10 ~ 50 之间 |
| enrollprovince | query | string | 否 | 招生省份筛选，例如江苏。enrollprovince、schoolname、majorname、specialId 四个参数不可同时为空。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 | |
| schoolname | query | string | 否 | 高校名称 (enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空) | |
| majorname | query | string | 否 | 专业名称，如电气工程与智能控制、计算机科学与技术等，默认为模糊搜索，可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空) | |
| majorNameStrict | query | boolean | 否 | false | 控制参数 majorname 是否为严格匹配搜索，默认为 false，模糊搜索 |
| specialId | query | integer | 否 | 0 | 专业 Id，如 22748，用于精确控制搜索的专业。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空) |
| year | query | integer | 是 | 无 | 必填，取值必须大于 0。查询年份。当前可选值：2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| min | query | integer | 否 | 0 | 录取最低分查询条件，筛选出最低分小于等于查询条件的值。默认值为 0，不进行筛选 |
| batchname | query | string | 否 | 专业录取批次筛选，多个值使用英文逗号分隔。当前全部可选值（共 181 项）：一本预科、一类模式本科、专科批、专科批A段、专科批F段、专科提前批、专科提前批A段、专科提前批B段、专科提前批E段、专项计划本科、体育专科提前批、体育本科批、体育本科提前批、体育类专科批、体育类专科提前批、体育类二本及预科批、体育类本科批、体育类本科提前批、体育类本科第二批、体育艺术本一U段、体育艺术本二W段、免费定向批（本科）、分类招生批、区域专项计划本科批、国家专项批、国家专项计划、国家专项计划(本二)、国家专项计划批、国家专项计划本科一批、国家专项计划本科批、国家及地方专项、南疆单列、对口援疆计划本科一批、国家及地方专项、南疆单列、对口援疆计划本科一批次、国家及地方专项、南疆单列、对口援疆计划本科二批、国家及地方专项、南疆单列、对口援疆计划本科二批次、地区专项计划批、地方专项批、地方专项计划、地方专项计划批、地方专项计划本科批、地方优师专项、地方农村专项计划、地方农村专项计划批次、地方农村专项计划本科批、少数民族预科班、平行录取一段、平行录取三段、平行录取二段、提前一批本科、提前二批本科、提前录取军校批、提前录取本科一批、提前录取本科二批、提前批、提前批A段、提前批A类、提前批B段、提前批B类、提前批第一批本科、提前批第二批本科、提前本科批、无批次、普通类一段、普通类二段、普通类平行录取、普通类提前批、本科A批、本科A段、本科B段、本科一批、本科一批-其他、本科一批A1段、本科一批A段、本科一批B段、本科一批H段、本科一批I段、本科一批U段、本科一批预科、本科一段、本科三批、本科三批A段、本科专项计划批、本科专项计划批E段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二批、本科二批-其他、本科二批A段、本科二批B段、本科二批C段、本科二批K段、本科二批及预科、本科二段、本科免费定向批、本科批、本科批A段、本科批A段（国家专项）、本科批A段（地方专项）、本科批B段、本科批C段、本科批一段、本科批平行组、本科批（区域教育均衡发展专项）、本科批（民委专项）、本科批（特殊类型）、本科批（预科）、本科批（高校专项）、本科提前一批、本科提前批、本科提前批-国家专项、本科提前批-高校专项、本科提前批A段、本科提前批A段-高校专项计划、本科提前批B段、本科提前批C、本科提前批C段、本科提前批D段、本科提前批艺术本科第二批、本科提前批艺术类、本科提前批艺术类A段、本科提前批艺术类第1小批、本科提前批艺术类第2小批、本科提前批（国家专项）、本科提前批（第2小批）、本科提前批（高校专项）、本科第一批、本科第一批提前批、本科第一阶段、本科第二批、本科第二批提前批、本科综合评价批、本科艺术甲批平行段、本科预科班批、民航飞行技术批、特殊类型批、特殊类型招生批、第一批、第二批B段、第二批第一段、第二批第二段、综合评价批次、艺本一批、艺术本科A段、艺术本科B段、艺术本科二批、艺术本科批A段、艺术本科批B段、艺术本科批C段、艺术本科提前批、艺术本科提前批B段、艺术类专科批、艺术类专科提前批、艺术类二本及预科批、艺术类本科A段、艺术类本科B段、艺术类本科批、艺术类本科批A段、艺术类本科批B段、艺术类本科提前批、艺术类本科提前批B段、艺术类本科提前批C段、艺术类本科第一阶段、艺术类第一批、艺术类第二批、艺术类第二批B段、艺术类（本科二批B段）、零志愿批次、零批次、预科升学批、高本贯通批、高校专项批、高校专项计划、高校专项计划批、高校专项计划批次、高校专项计划本一批、高校专项计划本科批、高校农村专项计划、高职专科提前批、高职专科提前批D段、高职专科提前批E段、高职（专科）批R段。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。 | |
| typename | query | string | 否 | 科类筛选。当前全部可选值（共 57 项）：3+证书、三校生、会计类、体育文、体育理、体育类、体育类（历史）、体育类（物理）、其他艺术、农学类、农林类、医学类、历史类、园林类、土建类、学考、学考文、学考理、幼师类、建筑类、护理类、教育类、文科、旅游类、服装设计与工艺类、机械加工类、汉授美术、汉授音乐、汽车类、汽驾类、烹饪类、牧医类、物理类、理科、电子商务类、电子技术类、电气技术类、畜牧兽医类、综合、美工设计类、美术类、艺术文、艺术理、艺术类、艺术类（不分科类）、艺术类（历史类）、艺术类（历史）、艺术类（物理）、药剂类、蒙授体育、蒙授文科、蒙授理科、蒙牧医类、计算机类、财会类、财经类、音乐类。适用取值随年份 year 和招生省份 provinceName 变化，例如海南 2025 为：综合。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.typeName。 | |
| schooluuid | query | string | 否 | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 | |
| schoolRegions | query | string | 否 | 院校热门区域筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前可选值：浙江省、京津冀、长三角、珠三角、大湾区、成渝地区、省会城市、一线城市、新一线城市、二线城市、沿海城市、偏远地区。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolRegions。 | |
| schoolProvinces | query | string | 否 | 院校所在省份筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前全部可选值（共 34 项）：北京、天津、河北、山西、内蒙古、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆、香港、澳门、台湾。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolProvinces。 | |
| schoolCategories | query | string | 否 | 院校类型筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前可选值：综合类、理工类、农林类、医药类、语言类、财经类、政法类、体育类、艺术类、民族类、军事类、师范类、其它。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolCategories。 | |
| schoolNatures | query | string | 否 | 院校办学性质筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前可选值：公办、民办、中外合作办学、内地与港澳台地区合作办学、境外高校独立办学。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolNatures。 | |
| educationLevels | query | string | 否 | 院校学历层次筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前可选值：本科、专科（高职）、其它。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字 段 Data.educationLevels。 | |
| schoolTags | query | string | 否 | 院校标签筛选，多个值使用英文逗号分隔，支持返回的代码或名称。当前全部可选值（共 71 项）：985、211、双一流、101计划、研究生院、保研、预强基、国家重点、部委院校、省属、省重点、省部共建、C9、E9、中坚九校、国防七子、五院四系、两电一邮、八大美院、七所海大、职业本科、中管高校、中央高校、兵工七子、军工七校、农林九校、外语六校、民族、中核、司法部校、公安院校、军校、五大警校、武警、华东五校、电气二龙、电气五虎、机械四小龙、机械五虎、建筑老八校、建筑新四军、两财一贸、医学霸主、南北双雄、南北双药、军地四医、财经五朵金花、中医老四校、师范六姐妹、原铁道部、原电力部、原邮电部、原电子工业部、原航天航空部、原财政部、原冶金部重点院校、原交通部、原石油工业部、原冶金工业部、原有色金属工业总公司直属、国家烟草专卖局共建高校、国家示范性微电子学院、新疆研究型大学、强基计划、双高计划、高水平学校建设单位、国家级示范、国家级骨干、现代学徒制试点院校、高水平专业群建设单位、教育部直属。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolTags。同一筛选项内多个值取并集，不同筛选项之间取交集。 | |
| minrange | query | string | 否 | 录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700 | |
| subjectSelection | query | string | 否 | 选科要求筛选。当前全部可选值（共 177 项）：不限、不限科目专业组、化/史/技(3选1)、化/史/生(3选1)、化/地/史(3选1)、化/地/技(3选1)、化/地/生(3选1)、化/政/史(3选1)、化/政/地(3选1)、化/政/技(3选1)、化/政/生(3选1)、化/生/地(3选1)、化/生/技(3选1)、化/生/政(3选1)、化、史、生(3科必选)、化、生、政(3科必选)、化史生(3科必选)、化学/地理(2选1)、化学/思想政治(2选1)、化学/技术(2选1)、化学/生物(2选1)、化学、地理(2科必选)、化学、技术(2科必选)、化学、生物(2科必选)、化学必选、历史、历史/地理(2选1)、历史/思想政治(2选1)、历史/生物(2选1)、历史、地理(2科必选)、历史、思想政治(2科必选)、历史必选、史//地(3选1)、史/化/地(3选1)、史/化/技(3选1)、史/化/政(3选1)、史/化/生(3选1)、史/地/技(3选1)、史/地/生(3选1)、史/政/地(3选1)、史/政/技(3选1)、史/生/地(3选1)、史/生/技(3选1)、史/生/政(3选1)、史、化、生(3科必选)、史、政、地(3科必选)、史政地(3科必选)、史生政(3科必选)、地/史/技(3选1)、地/史/生(3选1)、地/生/技(3选1)、地理/历史(2选1)、地理/技术(2选1)、地理/生物(2选1)、地理、历史(2科必选)、地理必选、思想政治/历史(2选1)、思想政治/地理(2选1)、思想政治/技术(2选1)、思想政治/生物(2选1)、思想政治、历史(2科必选)、思想政治、地理(2科必选)、思想政治必选、技术必选、政/史/地(3选1)、政/史/技(3选1)、政/史/生(3选1)、政/地/史(3选1)、政/地/技(3选1)、政/地/生(3选1)、政/生/技(3选1)、政、地、史(3科必选)、政地史(3科必选)、物/化/史(3选1)、物/化/地(3选1)、物/化/技(3选1)、物/化/政(3选1)、物/化/生(3选1)、物/史/化(3选1)、物/史/地(3选1)、物/史/技(3选1)、物/史/政(3选1)、物/史/生(3选1)、物/地/史(3选1)、物/地/技(3选1)、物/地/生(3选1)、物/政/史(3选1)、物/政/地(3选1)、物/政/技(3选1)、物/政/生(3选1)、物/生/地(3选1)、物/生/技(3选1)、物/生/政(3选1)、物、化、地(3科必选)、物、化、技(3科必选)、物、化、生(3科必选)、物、地、技(3科必选)、物、生、政(3科必选)、物化地(3科必选)、物化技(3科必选)、物化政(3科必选)、物化生(3科必选)、物地技(3科必选)、物理、物理/化学(2选1)、物理/历史(2选1)、物理/地理(2选1)、物理/思想政治(2选1)、物理/技术(2选1)、物理/生物(2选1)、物理、化学(2科必选)、物理、历史(2科必选)、物理、地理(2科必选)、物理、思想政治(2科必选)、物理、技术(2科必选)、物理、生物(2科必选)、物理必选、物生技(3科必选)、物生政(3科必选)、生/地/技(3选1)、生/政/地(3选1)、生/政/技(3选1)、生物/地理(2选1)、生物/思想政治(2选1)、生物/技术(2选1)、生物、地理(2科必选)、生物、思想政治(2科必选)、生物、技术(2科必选)、生物必选、首选不限，再选不限、首选不限，再选化学、首选不限，再选化学/生物(2选1)、首选不限，再选思想政治、首选不限，再选生物、首选历史，再选不限、首选历史，再选化学、首选历史，再选化学/地理(2选1)、首选历史，再选化学/思想政治(2选1)、首选历史，再选化学/生物(2选1)、首选历史，再选化学、地理(2科必选)、首选历史，再选化学、生物(2科必选)、首选历史，再选地理、首选历史，再选地理/生物(2选1)、首选历史，再选地理、生物(2科必选)、首选历史，再选思想政治、首选历史，再选思想政治/地理(2选1)、首选历史，再选思想政治/生物(2选1)、首选历史，再选思想政治、地理(2科必选)、首选历史，再选思想政治、生物(2科必选)、首选历史，再选生物、首选历史，再选生物/地理(2选1)、首选历史，再选生物/思想政治(2选1)、首选历史，再选生物、地理(2科必选)、首选历史，再选生物、思想政治(2科必选)、首选物理，再选不限、首选物理，再选化学、首选物理，再选化学/地理(2选1)、首选物理，再选化学/思想政治(2选1)、首选物理，再选化学/生物(2选1)、首选物理，再选化学、地理(2科必选)、首选物理，再选化学、思想政治(2科必选)、首选物理，再选化学、生物(2科必选)、首选物理，再选地理、首选物理，再选地理/生物(2选1)、首选物理，再选地理、生物(2科必选)、首选物理，再选思想政治、首选物理，再选思想政治/地理(2选1)、首选物理，再选思想政治/生物(2选1)、首选物理，再选思想政治、地理(2科必选)、首选物理，再选思想政治、生物(2科必选)、首选物理，再选生物、首选物理，再选生物/化学(2选1)、首选物理，再选生物/地理(2选1)、首选物理，再选生物/思想政治(2选1)、首选物理，再选生物、化学(2科必选)、首选物理，再选生物、地理(2科必选)、首选物理，再选生物、思想政治(2科必选)。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.subjectSelection。 | |
| sort | query | string | 否 | 排序控制，格式为 字段|排序方向。未传 sort 时使用默认排序：min > 0 时按 LowestScore|desc、Year|desc；min 为空或 0 时按 Year|desc；同分或同年记录按系统稳定顺序补位。排序方向可选 asc、desc：asc 表示升序（从小到大），desc 表示降序（从大到小）。多个排序条件用英文逗号分隔，并按传入顺序依次排序。支持字段：HighestScore（录取最高分，对应返回字段 HighSocre）、AverageScore（录取平均分，对应 AverageScore）、LowestScore（录取最低分，对应 LowestScore）、LowestRank（录取最低位次，对应 LowestSection）、ProvincialControlLine（省控线，对应 ProScore）、EnrollmentType（招生类型，部分源数据有值）、SelectionLevel（选测等级，主要用于特定省份历史数据）。示例：LowestScore|desc、LowestRank|asc、HighestScore|desc,LowestScore|desc。 | |
| excludeMajorCategory | query | boolean | 否 | false | 是否过滤专业大类数据，默认 false。传 true 时，过滤掉 MajorStandardCode 为空，或匹配 4 到 5 位大类编码的记录。 |
| restrictionTypes | query | string | 否 | 专业限报要求筛选，使用英文逗号传递多个代码，多个代码按 OR 匹配；不传表示不按限报要求筛选。当前全部可选值（共 10 项，传递 Code）：physical_exam（体检要求）、stutter（口吃限报）、hearing（听力要求）、left_handed（左利手）、gender （性别要求）、academic_score（成绩要求）、vision（视力要求）、color_vision（色盲色弱）、language（语种要求）、height（身高要求）。可选值请通过 历年高考专业录取分数线-查询参数枚举（/metadata/ceemajorline/enums）获取，使用返回字段 Data.restrictionTypes。 | |
| dataUpdatedForm | query | string | 否 | 按资料采集时间下限筛选，保留历史参数拼写。 |
独立请求示例
{
"schoolName": "北京大学",
"enrollProvince": "河北",
"pageIndex": 1,
"pageSize": 10,
"year": 2026,
"sort": "highestscore|desc",
"excludeMajorCategory": false
}返回契约
application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
},
"DistinctSchoolCount": {
"type": "integer",
"description": "此条件下的高校数量，一般用于展示多少高校符合筛选条件"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount",
"DistinctSchoolCount"
]
},
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"description": "数据记录 ID"
},
"AverageScore": {
"type": "string",
"description": "录取平均分，没有值时返回 '-'"
},
"BatchName": {
"type": "string",
"description": "专业录取批次筛选，多个值使用英文逗号分隔。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"ProvinceName": {
"type": "string",
"description": "招生的省份"
},
"TypeName": {
"type": "string",
"description": "科类筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.typeName。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"HighSocre": {
"type": "string",
"description": "该专业录取记录的最高分；HighSocre 为现有字段名，按原字段读取。"
},
"LowestScore": {
"type": "string",
"description": "对应年份、招生省份、科类及批次下该专业的最低录取分数，不代表未来录取结果。"
},
"LowestSection": {
"type": "string",
"description": "该专业录取记录的最低位次；比较时需保持同省、同年和同科类口径。"
},
"SchoolName": {
"type": "string",
"description": "高校名称"
},
"SchoolUUID": {
"type": "string",
"description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceecollegeline' target='_blank'>历年高考高校录取分数线</a> 接口中的 SchoolUUID 进行唯一匹配"
},
"SchoolProvince": {
"type": "string",
"description": "院校所在省份"
},
"SchoolCity": {
"type": "string",
"description": "院校所在城市"
},
"SchoolCategory": {
"type": "string",
"description": "院校类型"
},
"SchoolNature": {
"type": "string",
"description": "院校办学性质"
},
"EducationLevel": {
"type": "string",
"description": "院校学历层次"
},
"ProScore": {
"type": "string",
"description": "该录取记录对应的省控制分数线，用于对照专业最低录取分数。"
},
"MajorName": {
"type": "string",
"description": "专业名称"
},
"MajorCode": {
"type": "integer",
"description": "来源专业编号。表示原始数据来源中的专业 ID 或专业代码，不等同于教育部标准专业代码。"
},
"Year": {
"type": "integer",
"description": "招生年份"
},
"SubjectSelection": {
"type": "string",
"description": "选科要求数据"
},
"SubjectGroup": {
"type": "string",
"description": "录取记录中的专业组资料，应结合选科和当地批次口径理解。"
},
"MajorStandardCode": {
"type": "string",
"description": "标准专业代码。表示教育部专业目录中的标准专业代码，主要用于和专业库、招生计划、专业录取分数线等数据做标准化关联；如果为空，通常表示该专业名称暂未能匹配到唯一标准代码，或该记录是大类、试验班等非单一标准专业。"
},
"AdmissionMajorCode": {
"type": "string",
"description": "招生专业代码"
},
"SpecialMajorCode": {
"type": "string",
"description": "招生专业代码。表示数据来源中的招生专业编号或院校专业编号，通常是学校或来源系统里的专业标识，不等同于教育部标准专业代码。"
},
"campus": {
"type": "string",
"description": "办学地点。表示校区、城市、学院地点等办学位置信息。"
},
"special_requirements": {
"type": "string",
"description": "特殊要求。表示语种、性别、体检、收费、中外合作、师范、定向、专项、预科、订单培养等限制或说明。"
},
"RestrictionText": {
"type": "string",
"description": "该录取记录的限制条件文字，按原文展示；未提供时不代表没有报考限制。"
},
"DataUpdatedFrom": {
"type": "string",
"description": "资料采集日期，不是官方公告日期。"
},
"SchoolTags": {
"type": "array",
"items": {
"type": "string",
"description": "院校标签列表"
},
"description": "院校标签列表"
},
"major_category": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "专业大类。表示原始专业名称中的大类、试验班、实验班、专业类、方向包等集合型专业名称；普通单专业一般为空。对象字段包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"included_majors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"description": "包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"RestrictionTypes": {
"type": "array",
"items": {
"type": "string",
"description": "该记录的限制类型列表，可用于筛选及提示；完整要求还需结合 RestrictionText 和招生章程。"
},
"description": "该记录的限制类型列表，可用于筛选及提示；完整要求还需结合 RestrictionText 和招生章程。"
}
},
"required": [
"DataId",
"AverageScore",
"BatchName",
"ProvinceName",
"TypeName",
"HighSocre",
"LowestScore",
"LowestSection",
"SchoolName",
"SchoolUUID",
"SchoolProvince",
"SchoolCity",
"SchoolCategory",
"SchoolNature",
"EducationLevel",
"ProScore",
"MajorName",
"MajorCode",
"Year",
"SubjectSelection",
"SubjectGroup",
"MajorStandardCode",
"AdmissionMajorCode",
"SpecialMajorCode",
"campus",
"special_requirements",
"RestrictionText",
"DataUpdatedFrom",
"SchoolTags",
"major_category",
"included_majors",
"RestrictionTypes"
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
},
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}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{
"oneOf": [
{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
501
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "null",
"enum": [
null
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
},
{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
501
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
},
"DistinctSchoolCount": {
"type": "integer",
"description": "此条件下的高校数量，一般用于展示多少高校符合筛选条件"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount",
"DistinctSchoolCount"
]
},
"Data": {
"type": "array",
"maxItems": 0,
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"description": "数据记录 ID"
},
"AverageScore": {
"type": "string",
"description": "录取平均分，没有值时返回 '-'"
},
"BatchName": {
"type": "string",
"description": "专业录取批次筛选，多个值使用英文逗号分隔。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"ProvinceName": {
"type": "string",
"description": "招生的省份"
},
"TypeName": {
"type": "string",
"description": "科类筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/ceemajorline#anchor_related'>历年高考专业录取分数线-查询参数枚举</a>（/metadata/ceemajorline/enums）获取，使用返回字段 Data.typeName。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"HighSocre": {
"type": "string",
"description": "该专业录取记录的最高分；HighSocre 为现有字段名，按原字段读取。"
},
"LowestScore": {
"type": "string",
"description": "对应年份、招生省份、科类及批次下该专业的最低录取分数，不代表未来录取结果。"
},
"LowestSection": {
"type": "string",
"description": "该专业录取记录的最低位次；比较时需保持同省、同年和同科类口径。"
},
"SchoolName": {
"type": "string",
"description": "高校名称"
},
"SchoolUUID": {
"type": "string",
"description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceecollegeline' target='_blank'>历年高考高校录取分数线</a> 接口中的 SchoolUUID 进行唯一匹配"
},
"SchoolProvince": {
"type": "string",
"description": "院校所在省份"
},
"SchoolCity": {
"type": "string",
"description": "院校所在城市"
},
"SchoolCategory": {
"type": "string",
"description": "院校类型"
},
"SchoolNature": {
"type": "string",
"description": "院校办学性质"
},
"EducationLevel": {
"type": "string",
"description": "院校学历层次"
},
"ProScore": {
"type": "string",
"description": "该录取记录对应的省控制分数线，用于对照专业最低录取分数。"
},
"MajorName": {
"type": "string",
"description": "专业名称"
},
"MajorCode": {
"type": "integer",
"description": "来源专业编号。表示原始数据来源中的专业 ID 或专业代码，不等同于教育部标准专业代码。"
},
"Year": {
"type": "integer",
"description": "招生年份"
},
"SubjectSelection": {
"type": "string",
"description": "选科要求数据"
},
"SubjectGroup": {
"type": "string",
"description": "录取记录中的专业组资料，应结合选科和当地批次口径理解。"
},
"MajorStandardCode": {
"type": "string",
"description": "标准专业代码。表示教育部专业目录中的标准专业代码，主要用于和专业库、招生计划、专业录取分数线等数据做标准化关联；如果为空，通常表示该专业名称暂未能匹配到唯一标准代码，或该记录是大类、试验班等非单一标准专业。"
},
"AdmissionMajorCode": {
"type": "string",
"description": "招生专业代码"
},
"SpecialMajorCode": {
"type": "string",
"description": "招生专业代码。表示数据来源中的招生专业编号或院校专业编号，通常是学校或来源系统里的专业标识，不等同于教育部标准专业代码。"
},
"campus": {
"type": "string",
"description": "办学地点。表示校区、城市、学院地点等办学位置信息。"
},
"special_requirements": {
"type": "string",
"description": "特殊要求。表示语种、性别、体检、收费、中外合作、师范、定向、专项、预科、订单培养等限制或说明。"
},
"RestrictionText": {
"type": "string",
"description": "该录取记录的限制条件文字，按原文展示；未提供时不代表没有报考限制。"
},
"DataUpdatedFrom": {
"type": "string",
"description": "资料采集日期，不是官方公告日期。"
},
"SchoolTags": {
"type": "array",
"items": {
"type": "string",
"description": "院校标签列表"
},
"description": "院校标签列表"
},
"major_category": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "专业大类。表示原始专业名称中的大类、试验班、实验班、专业类、方向包等集合型专业名称；普通单专业一般为空。对象字段包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"included_majors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"description": "包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。"
},
"RestrictionTypes": {
"type": "array",
"items": {
"type": "string",
"description": "该记录的限制类型列表，可用于筛选及提示；完整要求还需结合 RestrictionText 和招生章程。"
},
"description": "该记录的限制类型列表，可用于筛选及提示；完整要求还需结合 RestrictionText 和招生章程。"
}
},
"required": [
"DataId",
"AverageScore",
"BatchName",
"ProvinceName",
"TypeName",
"HighSocre",
"LowestScore",
"LowestSection",
"SchoolName",
"SchoolUUID",
"SchoolProvince",
"SchoolCity",
"SchoolCategory",
"SchoolNature",
"EducationLevel",
"ProScore",
"MajorName",
"MajorCode",
"Year",
"SubjectSelection",
"SubjectGroup",
"MajorStandardCode",
"AdmissionMajorCode",
"SpecialMajorCode",
"campus",
"special_requirements",
"RestrictionText",
"DataUpdatedFrom",
"SchoolTags",
"major_category",
"included_majors",
"RestrictionTypes"
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
},
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}
]
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数缺失、非法、重复或冲突 | HTTP 400 |
| 501 | 处理、依赖失败或超时 | HTTP 400 |
| 501 | 服务端筛选参数校验仍使用原六字段状态与空数组；入口参数错误为五字段状态与null | HTTP 400 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13