历年高考高校录取分数线 API 接口
接口详情官网地址: https://www.gugudata.com/api/details/ceecollegeline
历年高考高校录取分数线 API 高校在各省录取分数线，基础数据、高校高考等关键词场景常会用到，适合用于字典与基础库查询、教育与行业数据整合与筛选条件补全与业务检索等业务场景，方便开发者直接在应用、脚本或数据流程中接入。
1. 产品功能
- 2026 年数据即将更新；
- 全国所有高校在全国各省的详细录取数据，从 2015 年至 2025 年；
- 百万级别已校对历史数据；
- 多种查询条件便于多维度分析；
- 数据持续自动更新与维护；
- 毫秒级查询性能；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
2. API 文档
接口地址: https://api.gugudata.com/metadata/ceecollegeline
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
数据预览: https://www.gugudata.com/preview/ceecollegeline
接口测试: https://api.gugudata.com/metadata/ceecollegeline/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| searchtype | string | 是 | YOUR_VALUE | 查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME |
| keyword | string | 是 | YOUR_VALUE | 录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME，此参数值传递录取省份；searchtype=COLLEGENAME，此参数值传递高校名称。招生省份枚举：上海\ |
| pageindex | int | 是 | 1 | 分页参数，第几页 |
| pagesize | int | 是 | 10 | 分页参数，每页总条数，取值范围在 1 ~ 20 之间（含） |
| year | int | 是 | YOUR_VALUE | 查询的录取年份，如 2020、2021、2022、2023、2024、2025。参数默认值为 0：即获取所有年份的录取数据 |
| min | int | 否 | YOUR_VALUE | 录取最低分查询条件，筛选出最低分小于等于查询条件的值 |
| type | string | 否 | YOUR_VALUE | 传递的参数值可选为：3+证书\ |
| keywordstrict | string | 否 | false | 控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询 |
| enrollprovince | string | 否 | YOUR_VALUE | 用于 searchtype=COLLEGENAME 时，附加一个招生省份的条件，如查询北京大学在江苏的录取数据，那么该值传递 “江苏” 即可 |
| batchname | string | 否 | YOUR_VALUE | 录取批次参数，可使用英文逗号分隔传递多个值。可选枚举值：专科批\ |
| collegeprovincename | string | 否 | YOUR_VALUE | 学院所属省份筛选，如获取所有江苏省高校的录取分数线，那么该值传递 “江苏” 即可，院校省份枚举：上海\ |
| enrollmenttype | string | 否 | YOUR_VALUE | 招生类型筛选，如：普通类 |
| schooluuid | string | 否 | YOUR_VALUE | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| sort | string | 否 | YOUR_VALUE | 排序控制，格式为字段+排序类型（asc、desc），支持参数 HighestScore\ |
| minrange | string | 否 | 0 | 录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，一般用于分页计算 |
| DataStatus.RequestParameter | string | 请求参数，一般用于调试 |
| Data.Province | string | 招生的省份 |
| Data.SchoolUUID | string | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| Data.CollegeName | string | 高校名称 |
| Data.Year | int | 招生年份 |
| Data.HighestScore | string | 录取最高分 |
| Data.AverageScore | string | 录取平均分 |
| Data.LowestScore | string | 录取最低分 |
| Data.LowestRank | string | 录取最低位次 |
| Data.ProvincialControlLine | string | 录取省控线 |
| Data.EnrollmentType | string | 招生类型 |
| Data.SelectionLevel | string | 选测等级（特定省） |
| Data.AdmissionBatch | string | 录取批次。枚举值为：专科批\ |
| Data.TypeName | string | 文科、理科或综合。枚举值为：理科\ |
| Data.CourseSelection | string | 选科要求 |
| Data.CourseSelectionName | string | 专业组 |
| Data.SchoolType | string | 学校类型，如公办、民办 |
| Data.SchoolInCity | string | 高校所在的城市 |
| Data.Is985 | boolean | 是否为 985 院校 |
| Data.Is211 | boolean | 是否为 211 院校 |
| Data.IsDualClass | boolean | 是否为双一流院校 |
| Data.CoverImage | string | 高校 logo |
5. 错误码说明
| 状态码 | 错误说明 | 备注 |
|---|---|---|
| 100 | 正常返回 | - |
| 101 | 参数错误 | - |
| 102 | 请求频率受限 | 每秒请求不能超过 100 次 |
| 103 | 账号欠费 | - |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 接口响应错误 | - |
6. 适用场景
- 适合用于字典与基础库查询，快速补齐产品侧需要的 历年高考高校录取分数线 数据能力。
- 适合用于教育与行业数据整合，减少手工整理、清洗与重复开发成本。
- 适合用于筛选条件补全与业务检索，将接口结果直接接入后台系统、数据任务或内容处理流程。
7. 相关接口
- 相关接口：历年高考高校录取分数线-查询参数枚举（GET），返回 type、batchName、enrollmentType、collegeProvinceName 的枚举集合。
Top comments (0)