历年高考专业录取分数线 API 接口
接口详情官网地址: https://www.gugudata.com/api/details/ceemajorline
历年高考专业录取分数线 API 高校专业各省录取分数线,基础数据、高校高考等关键词场景常会用到,适合用于字典与基础库查询、教育与行业数据整合与筛选条件补全与业务检索等业务场景,方便开发者直接在应用、脚本或数据流程中接入。
1. 产品功能
- 2026 年数据即将更新,每年数据定时更新;
- 全国高校各专业在全国各省的详细录取数据,从 2018 年至 2025 年;
- 一千多万条已智能校对数据;
- 提供按照高校分组的专业枚举信息前置查询接口;
- 在已有数据基础上,有定制化的接口也可联系我们;
- 多种查询参数条件便于多维度分析;
- 返回数据包含该专业录取的最低分、最高分、平均分、最低位次等信息;
- 数据持续更新与维护;
- 毫秒级查询性能;
- 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
- 接口安全标准全面兼容 Apple ATS;
- 全国多节点 CDN 部署;
- 接口极速响应,多台服务器构建 API 接口负载均衡;
2. API 文档
接口地址: https://api.gugudata.com/metadata/ceemajorline
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
数据预览: https://www.gugudata.com/preview/ceemajorline
接口测试: https://api.gugudata.com/metadata/ceemajorline/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| pageindex | int | 是 | 1 | 分页参数,第几页 |
| pagesize | int | 是 | 10 | 分页参数,每页总条数,取值范围在 10 ~ 50 之间 |
| enrollprovince | string | 否 | YOUR_VALUE | 招生省份的条件,如查询北京大学计算机科学与技术专业在江苏的录取数据,那么该值传递 “江苏” 即可。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数,但不可同时为空),招生省份可选枚举:上海\ |
| schoolname | string | 否 | YOUR_VALUE | 高校名称 (enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数,但不可同时为空) |
| majorname | string | 否 | YOUR_VALUE | 专业名称,如电气工程与智能控制、计算机科学与技术等,默认为模糊搜索,可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数,但不可同时为空) |
| majorNameStrict | boolean | 否 | false | 控制参数 majorname 是否为严格匹配搜索,默认为 false,模糊搜索 |
| specialId | int | 否 | YOUR_VALUE | 专业 Id,如 22748,用于精确控制搜索的专业。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数,但不可同时为空) |
| year | int | 是 | 0 | 查询的录取年份,如 2020、2021、2022、2023、2024、2025。参数默认值为 0:即获取所有年份的录取数据 |
| min | int | 否 | 0 | 录取最低分查询条件,筛选出最低分小于等于查询条件的值。默认值为 0,不进行筛选 |
| batchname | string | 否 | YOUR_VALUE | 专业所属的录取批次,可使用英文逗号分隔传递多个值,格式为:本科二批,专科批。传递参数可选值为:一类模式本科\ |
| typename | string | 否 | YOUR_VALUE | 专业所属的类型,传递参数可选值为:3+证书\ |
| schooluuid | string | 否 | YOUR_VALUE | 咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| minrange | string | 否 | YOUR_VALUE | 录取最低分区间查询条件,使用逗号分隔,左右都为闭区间,格式为:500,700 |
| subjectSelection | string | 否 | YOUR_VALUE | 选科要求筛选条件,如:首选物理,再选化学。传递参数可选值为:不限\ |
| sort | string | 否 | YOUR_VALUE | 排序控制,格式为字段+排序类型(asc、desc),支持参数 HighestScore\ |
| excludeMajorCategory | boolean | 否 | false | 是否过滤专业大类数据,默认 false。传 true 时,过滤掉 MajorStandardCode 为空,或匹配 4 到 5 位大类编码的记录。 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量,一般用于分页计算 |
| DataStatus.DistinctSchoolCount | int | 此条件下的高校数量,一般用于展示多少高校符合筛选条件 |
| DataStatus.RequestParameter | string | 请求参数,一般用于调试 |
| Data.ProvinceName | string | 招生的省份 |
| Data.SchoolUUID | string | 咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息、历年高考高校录取分数线 接口中的 SchoolUUID 进行唯一匹配 |
| Data.SchoolName | string | 高校名称 |
| Data.MajorName | string | 专业名称 |
| Data.MajorCode | int | 专业代码 |
| Data.Year | int | 招生年份 |
| Data.HighSocre | int\ | string |
| Data.AverageScore | int\ | string |
| Data.LowestScore | int | 录取最低分 |
| Data.LowestSection | int\ | string |
| Data.BatchName | string | 录取批次,枚举值为:一类模式本科\ |
| Data.TypeName | string | 专业所属的类型,枚举值为:3+证书\ |
| Data.ProScore | int\ | string |
| Data.subjectSelection | string | 选科要求数据 |
| Data.MajorStandardCode | string | 标准专业代码,部分新增专业数据不匹配返回空 |
5. 错误码说明
| 状态码 | 错误说明 | 备注 |
|---|---|---|
| 100 | 正常返回 | - |
| 101 | 参数错误 | - |
| 102 | 请求频率受限 | 每秒请求不能超过 100 次 |
| 103 | 账号欠费 | - |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 接口响应错误 | - |
6. 适用场景
- 适合用于字典与基础库查询,快速补齐产品侧需要的 历年高考专业录取分数线 数据能力。
- 适合用于教育与行业数据整合,减少手工整理、清洗与重复开发成本。
- 适合用于筛选条件补全与业务检索,将接口结果直接接入后台系统、数据任务或内容处理流程。
7. 相关接口
- 前置接口:历年高考专业录取分数线-专业类别(GET),返回专业分类层级数据。
- 相关接口:历年高考专业录取分数线-查询参数枚举(GET),返回 batchName、typeName、subjectSelection 的枚举集合。

Top comments (0)