DEV Community

GuGuData
GuGuData

Posted on • Edited on

历年高考专业录取分数线 API 接口

历年高考专业录取分数线 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/ceemajorline

历年高考专业录取分数线 API 高校专业各省录取分数线,基础数据、高校高考等关键词场景常会用到,适合用于字典与基础库查询、教育与行业数据整合与筛选条件补全与业务检索等业务场景,方便开发者直接在应用、脚本或数据流程中接入。

gugudata_api_cover

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://api.gugudata.com/metadata/ceemajorline?appkey=YOUR_APPKEY&pageindex=1&pagesize=10&enrollprovince=YOUR_VALUE&schoolname=YOUR_VALUE&majorname=YOUR_VALUE&majorNameStrict=false&specialId=YOUR_VALUE&year=0&min=0&batchname=YOUR_VALUE&typename=YOUR_VALUE&schooluuid=YOUR_VALUE&minrange=YOUR_VALUE&subjectSelection=YOUR_VALUE&sort=YOUR_VALUE&excludeMajorCategory=false

数据预览: 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. 相关接口

Top comments (0)