历年高考专业录取分数线

历年高考专业录取分数线
接口详情官网地址: https://www.gugudata.com/api/details/ceemajorline

高校专业各省录取分数线

请求方法: GET
接口路径: /metadata/ceemajorline
调试地址: https://api.gugudata.com/metadata/ceemajorline/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY

pageindex (int, 必填): 分页参数，第几页

pagesize (int, 必填): 分页参数，每页总条数，取值范围在 10 ~ 50 之间

enrollprovince (string, 可选): 招生省份的条件，如查询北京大学计算机科学与技术专业在江苏的录取数据，那么该值传递 “江苏” 即可。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)，招生省份可选枚举：上海|云南|内蒙古|北京|台湾|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江

schoolname (string, 可选): 高校名称 (enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)

majorname (string, 可选): 专业名称，如电气工程与智能控制、计算机科学与技术等，默认为模糊搜索，可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)

majorNameStrict (boolean, 可选): 控制参数 majorname 是否为严格匹配搜索，默认为 false，模糊搜索

specialId (int, 可选): 专业 Id，如 22748，用于精确控制搜索的专业。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)

year (int, 必填): 查询的录取年份，如 2020、2021、2022、2023、2024、2025。参数默认值为 0：即获取所有年份的录取数据

min (int, 可选): 录取最低分查询条件，筛选出最低分小于等于查询条件的值。默认值为 0，不进行筛选

typename (string, 可选): 专业所属的类型，传递参数可选值为：3+证书|会计类|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|农林类|医学类|历史类|园林类|土建类|学考|学考文|学考理|幼师类|建筑类|护理类|教育类|文科|旅游类|服装设计与工艺类|机械加工类|汉授美术|汉授音乐|汽车类|汽驾类|烹饪类|牧医类|物理类|理科|电子商务类|电子技术类|电气技术类|畜牧兽医类|综合|美工设计类|美术类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|药剂类|蒙授体育|蒙授文科|蒙授理科|蒙牧医类|计算机类|财会类|财经类|音乐类

schooluuid (string, 可选): 咕咕数据平台高校唯一 ID，此唯一 ID 可与全国大学高校基础信息、历年高考专业录取分数线等接口中的 SchoolUUID 进行唯一匹配

minrange (string, 可选): 录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700

sort (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 (boolean, 可选): 是否过滤专业大类数据，默认 false。传 true 时，过滤掉 MajorStandardCode 为空，或匹配 4 到 5 位大类编码的记录。

返回字段:

DataStatus.StatusCode: 接口返回状态码

DataStatus.StatusDescription: 接口返回状态说明

DataStatus.ResponseDateTime: 接口数据返回时间

DataStatus.DataTotalCount: 此条件下的总数据量，一般用于分页计算

DataStatus.DistinctSchoolCount: 此条件下的高校数量，一般用于展示多少高校符合筛选条件

DataStatus.RequestParameter: 请求参数，一般用于调试

Data.ProvinceName: 招生的省份

Data.SchoolUUID: 咕咕数据平台高校唯一 ID，此唯一 ID 可与全国大学高校基础信息、历年高考高校录取分数线接口中的 SchoolUUID 进行唯一匹配

Data.SchoolName: 高校名称

Data.MajorName: 专业名称

Data.MajorCode: 来源专业编号。表示原始数据来源中的专业 ID 或专业代码，不等同于教育部标准专业代码。

Data.Year: 招生年份

Data.HighSocre: 录取最高分，没有值时返回 '-'

Data.AverageScore: 录取平均分，没有值时返回 '-'

Data.LowestScore: 录取最低分

Data.LowestSection: 录取最低位次，没有值时返回 '-'

Data.TypeName: 专业所属的类型，枚举值为：3+证书|会计类|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|农林类|医学类|历史类|园林类|土建类|学考|学考文|学考理|幼师类|建筑类|护理类|教育类|文科|旅游类|服装设计与工艺类|机械加工类|汉授美术|汉授音乐|汽车类|汽驾类|烹饪类|牧医类|物理类|理科|电子商务类|电子技术类|电气技术类|畜牧兽医类|综合|美工设计类|美术类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|药剂类|蒙授体育|蒙授文科|蒙授理科|蒙牧医类|计算机类|财会类|财经类|音乐类

Data.ProScore: 对应专业在对应省份录取的省控线，没有值时会返回 '-'

Data.subjectSelection: 选科要求数据

Data.SubjectGroup: 院校专业组。表示该专业所属的招生专业组或专业组编号，例如“(301)”。

Data.MajorStandardCode: 标准专业代码。表示教育部专业目录中的标准专业代码，主要用于和专业库、招生计划、专业录取分数线等数据做标准化关联；如果为空，通常表示该专业名称暂未能匹配到唯一标准代码，或该记录是大类、试验班等非单一标准专业。

Data.SpecialMajorCode: 招生专业代码。表示数据来源中的招生专业编号或院校专业编号，通常是学校或来源系统里的专业标识，不等同于教育部标准专业代码。

Data.major_category: 专业大类。表示原始专业名称中的大类、试验班、实验班、专业类、方向包等集合型专业名称；普通单专业一般为空。对象字段包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。

Data.included_majors: 包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。

Data.campus: 办学地点。表示校区、城市、学院地点等办学位置信息。

Data.special_requirements: 特殊要求。表示语种、性别、体检、收费、中外合作、师范、定向、专项、预科、订单培养等限制或说明。

HTTP 状态码:

200 接口正常响应: 业务状态码请结合响应体中的状态字段判断。

400 请求参数错误: 参数缺失、格式错误或非法组合。

401 鉴权失败: 缺少 APPKEY 或 APPKEY 无效。

403 无权限或额度不可用: 订单到期、权限不足或剩余额度不可用。

404 资源不存在: 请求路径不存在。

405 请求方法不允许: 请求方法与接口定义不匹配。

415 请求内容类型不支持: 文件上传或请求体格式不符合要求。

429 请求频率超限: 触发接口或网关限流策略。

500 服务内部异常: 服务执行异常，请联系技术支持。

502 上游依赖异常: 上游服务响应异常或暂不可用。

业务状态码:

100 正常返回: 暂无说明

101 参数错误: 暂无说明

102 请求频率受限: 每秒请求不能超过 100 次

103 账号欠费: 暂无说明

104 APPKEY 错误: 请检查传递的 APPKEY 是否为开发者中心获取到的值

110 接口响应错误: 暂无说明

接口特性:

2026 年数据即将更新，每年数据定时更新；

全国高校各专业在全国各省的详细录取数据，从 2018 年至 2025 年；

一千多万条已智能校对数据；

提供按照高校分组的专业枚举信息前置查询接口；

在已有数据基础上，有定制化的接口也可联系我们；

多种查询参数条件便于多维度分析；

返回数据包含该专业录取的最低分、最高分、平均分、最低位次等信息；

数据持续更新与维护；

毫秒级查询性能；

全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；

全面兼容 Apple ATS；

全国多节点 CDN 部署；

接口调用状态与状态监控：https://www.gugudata.com/status。

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "DistinctSchoolCount": 0,
        "RequestParameter": "string"
    },
    "Data": {
        "ProvinceName": "string",
        "SchoolUUID": "string",
        "SchoolName": "string",
        "MajorName": "string",
        "MajorCode": 0,
        "Year": 0,
        "HighSocre": "string",
        "AverageScore": "string",
        "LowestScore": 0,
        "LowestSection": "string",
        "BatchName": "string",
        "TypeName": "string",
        "ProScore": "string",
        "subjectSelection": "string",
        "SubjectGroup": "string",
        "MajorStandardCode": "string",
        "SpecialMajorCode": "string",
        "major_category": {
            "property1": "string",
            "property2": "string"
        },
        "included_majors": [
            {
                "property1": "string",
                "property2": "string"
            }
        ],
        "campus": "string",
        "special_requirements": "string",
        "SchoolProvince": "string",
        "SchoolCity": "string",
        "SchoolCategory": "string",
        "SchoolNature": "string",
        "EducationLevel": "string",
        "SchoolTags": [
            "string"
        ]
    }
}

请求参数

请求示例代码

返回响应