[DEMO] 历年高考专业录取分数线
GET
https://api.gugudata.com/metadata/ceemajorline/demo
GET /metadata/ceemajorline/demo业务说明
独立请求示例
{
"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{
"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
请求参数
无
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-03 03:04:17