API 文档
接口地址: https://api.gugudata.com/metadata/ceecollegeline
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/metadata/ceecollegeline?appkey=APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0
数据预览: https://www.gugudata.com/preview/ceecollegeline
接口测试: https://api.gugudata.com/metadata/ceecollegeline/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 历年高考高校录取分数线-查询参数枚举
前置接口地址: https://api.gugudata.com/metadata/ceecollegeline/enums
前置接口参数说明: appkey=YOUR_APPKEY&year=2025&provinceName=上海
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 返回 type、batchName、enrollmentType、collegeProvinceName 的枚举集合
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
APPKEY |
付费后获取的 APPKEY |
| searchtype |
string |
是 |
|
查询条件类型,支持录取省份以及高校名称查询,参数值分别为:PROVINCENAME 或 COLLEGENAME |
| keyword |
string |
是 |
|
录取省份或高校名称,高校名称支持模糊查询。searchtype=PROVINCENAME 时传招生省份;searchtype=COLLEGENAME 时传高校名称。招生省份当前可选值:上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| pageindex |
integer |
是 |
1 |
分页参数,第几页 |
| pagesize |
integer |
是 |
10 |
分页参数,每页总条数,取值范围在 1 ~ 20 之间(含) |
| year |
integer |
是 |
|
查询年份。当前可选值:2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| min |
integer |
否 |
|
录取最低分查询条件,筛选出最低分小于等于查询条件的值 |
| type |
string |
否 |
|
科类筛选。当前全部可选值(共 14 项):综合、艺术类、体育类(历史)、体育类(物理)、历史类、物理类、艺术类(历史)、艺术类(物理)、文科、理科、体育类、蒙授文科、蒙授理科、艺术文。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.type。 |
| keywordstrict |
string |
否 |
false |
控制 keyword 参数在查询高校名称时是否进行模糊查询,true 为精确匹配,默认值为 false 进行模糊查询 |
| enrollprovince |
string |
否 |
|
searchtype=COLLEGENAME 时附加招生省份筛选,例如江苏。当前可选值:上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| batchname |
string |
否 |
|
录取批次筛选,可使用英文逗号分隔传递多个值。当前全部可选值(共 74 项):专科批、本科批、本科批(民委专项)、本科提前批、本科提前批A段、艺术类专科批、艺术类本科批、专科提前批、本科批A段、本科批B段、本科提前批B段、体育类本科批、体育类本科提前批、国家专项计划本科批、本科提前批C段、艺术类本科提前批、艺术类本科提前批B段、高校专项计划批次、提前一批本科、提前二批本科、本科一批、本科一批A1段、本科一批A段、本科一批B段、本科二批A段、本科二批B段、本科二批C段、高校专项计划批、高校专项计划本科批、本科二批、本科提前批C、专科提前批A段、提前批、零志愿批次、体育类专科批、平行录取一段、平行录取二段、普通类一段、普通类平行录取、普通类提前批、第二批第一段、第二批第二段、地方专项计划本科批、特殊类型招生批、专科批F段、本科批C段、专科特殊类型批次K段、本科一段、本科专项计划批、本科专项计划批E段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二段、专项计划本科、本科提前二批、国家及地方专项、南疆单列、对口援疆计划本科一批、国家及地方专项、南疆单列、对口援疆计划本科一批次、国家及地方专项、南疆单列、对口援疆计划本科二批、国家及地方专项、南疆单列、对口援疆计划本科二批次、高职专科提前批、提前批A段、提前批B段、专科提前批B段、地方农村专项计划批次、综合评价批次、本科批(特殊类型)、特殊类型批、国家专项计划批、提前录取军校批、提前录取本科一批、提前录取本科二批、高职专科提前批E段、综合评价批。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.batchName。 |
| collegeprovincename |
string |
否 |
|
院校所在省份筛选,例如江苏。当前全部可选值(共 32 项):上海、云南、北京、吉林、四川、天津、山东、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、福建、辽宁、重庆、陕西、香港、安徽、山西、新疆、甘肃、西藏、贵州、黑龙江、内蒙古、宁夏、青海。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.collegeProvinceName。 |
| enrollmenttype |
string |
否 |
|
招生类型筛选,例如普通类。示例:普通类、中外合作办学、国家专项计划、地方专项计划、高校专项计划、民族班、预科班、定向、少数民族、新疆内地班 等,完整见枚举接口(共约 1396 项,随年份与省份变化)。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.enrollmentType。 |
| schooluuid |
string |
否 |
|
咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| sort |
string |
否 |
|
排序控制,格式为 字段|排序方向。未传 sort 时使用默认排序:min > 0 时按 LowestScore|desc、Year|desc;min 为空或 0 时按 Year|desc;同分或同年记录按系统稳定顺序补位。排序方向可选 asc、desc:asc 表示升序(从小到大),desc 表示降序(从大到小)。多个排序条件用英文逗号分隔,并按传入顺序依次排序。支持字段:HighestScore(录取最高分,对应返回字段 HighestScore)、AverageScore(录取平均分,对应 AverageScore)、LowestScore(录取最低分,对应 LowestScore)、LowestRank(录取最低位次,对应 LowestRank)、ProvincialControlLine(省控线,对应 ProvincialControlLine)、EnrollmentType(招生类型,对应 EnrollmentType)、SelectionLevel(选测等级,对应 SelectionLevel,主要用于特定省份历史数据)。示例:LowestScore|desc、LowestRank|asc、HighestScore|desc,LowestScore|desc。 |
| minrange |
string |
否 |
0 |
录取最低分区间查询条件,使用逗号分隔,左右都为闭区间,格式为:500,700 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.StatusCode |
integer |
接口返回状态码 |
| DataStatus.StatusDescription |
string |
接口返回状态说明 |
| DataStatus.ResponseDateTime |
string |
接口数据返回时间 |
| DataStatus.DataTotalCount |
integer |
此条件下的总数据量,一般用于分页计算 |
| DataStatus.RequestParameter |
string |
请求参数,一般用于调试 |
| Data.Province |
string |
招生的省份 |
| Data.SchoolUUID |
string |
咕咕数据平台高校唯一 ID,此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| Data.CollegeName |
string |
高校名称 |
| Data.Year |
integer |
招生年份 |
| Data.HighestScore |
string |
录取最高分 |
| Data.AverageScore |
string |
录取平均分 |
| Data.LowestScore |
string |
录取最低分 |
| Data.LowestRank |
string |
录取最低位次 |
| Data.ProvincialControlLine |
string |
录取省控线 |
| Data.EnrollmentType |
string |
招生类型 |
| Data.SelectionLevel |
string |
选测等级(特定省) |
| Data.AdmissionBatch |
string |
录取批次筛选,可使用英文逗号分隔传递多个值。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。 |
| Data.TypeName |
string |
科类筛选。可选值请通过 历年高考高校录取分数线-查询参数枚举(/metadata/ceecollegeline/enums)获取,使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。 |
| 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 |