历年高考高校录取分数线
GET
https://api.gugudata.com/metadata/ceecollegeline
GET /metadata/ceecollegeline业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| searchtype | query | string | 是 | 无 | 查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME |
| keyword | query | string | 是 | 无 | 录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME 时传招生省份；searchtype=COLLEGENAME 时传高校名称。招生省份当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| pageindex | query | integer | 是 | 无 | 分页参数，第几页 |
| pagesize | query | integer | 是 | 无 | 分页参数，每页总条数，取值范围在 1 ~ 20 之间（含） |
| year | query | integer | 是 | 无 | 查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| min | query | integer | 否 | 0 | 录取最低分查询条件，筛选出最低分小于等于查询条件的值 |
| type | query | string | 否 | 科类筛选。当前全部可选值（共 14 项）：综合、艺术类、体育类（历史）、体育类（物理）、历史类、物理类、艺术类（历史）、艺术类（物理）、文科、理科、体育类、蒙授文科、蒙授理科、艺术文。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。 | |
| keywordstrict | query | string | 否 | false | 控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询 |
| enrollprovince | query | string | 否 | searchtype=COLLEGENAME 时附加招生省份筛选，例如江苏。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 | |
| batchname | query | 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 | query | string | 否 | 院校所在省份筛选，例如江苏。当前全部可选值（共 32 项）：上海、云南、北京、吉林、四川、天津、山东、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、福建、辽宁、重庆、陕西、香港、安徽、山西、新疆、甘肃、西藏、贵州、黑龙江、内蒙古、宁夏、青海。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.collegeProvinceName。 | |
| enrollmenttype | query | string | 否 | 招生类型筛选，例如普通类。示例：普通类、中外合作办学、国家专项计划、地方专项计划、高校专项计划、民族班、预科班、定向、少数民族、新疆内地班 等，完整见枚举接口（共约 1396 项，随年份与省份变化）。可选值请通过 历年高考高校录取分数线-查询参数枚举（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.enrollmentType。 | |
| schooluuid | query | string | 否 | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 | |
| sort | query | 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 | query | string | 否 | 录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700 | |
| dataUpdatedForm | query | string | 否 | 按资料采集时间下限筛选，保留历史参数 拼写；不是录取年度或官方公告发布日期。 |
独立请求示例
{
"searchType": "COLLEGENAME",
"keyword": "北京大学",
"pageIndex": 1,
"pageSize": 10,
"year": 2026,
"sort": "highestscore|desc"
}返回契约
application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"description": "数据记录 ID"
},
"Province": {
"type": "string",
"description": "该录取线面向的考生招生省份；与高校所在省份、城市区分使用。"
},
"CollegeName": {
"type": "string",
"description": "高校名称"
},
"SchoolUUID": {
"type": "string",
"description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 SchoolUUID 进行唯一匹配"
},
"Year": {
"type": "integer",
"description": "招生年份"
},
"HighestScore": {
"type": "string",
"description": "录取最高分"
},
"AverageScore": {
"type": "string",
"description": "录取平均分"
},
"LowestScore": {
"type": "string",
"description": "对应年份、招生省份、科类、批次及招生类型下的最低录取分数，不是下一年度录取承诺。"
},
"LowestRank": {
"type": "string",
"description": "对应录取记录的最低位次，需在同省、同年、同科类口径下比较。"
},
"ProvincialControlLine": {
"type": "string",
"description": "该录取记录对应的省级批次控制线，不等同于院校最低录取分数。"
},
"EnrollmentType": {
"type": "string",
"description": "招生类型"
},
"SelectionLevel": {
"type": "string",
"description": "选测等级（特定省）"
},
"AdmissionBatch": {
"type": "string",
"description": "录取批次筛选，可使用英文逗号分隔传递多个值。可选值请通过 <a href='https://www.gugudata.com/api/details/ceecollegeline#anchor_related'>历年高考高校录取分数线-查询参数枚举</a>（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"TypeName": {
"type": "string",
"description": "科类筛选。可选值请通过 <a href='https://www.gugudata.com/api/details/ceecollegeline#anchor_related'>历年高考高校录取分数线-查询参数枚举</a>（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。"
},
"SchoolType": {
"type": "string",
"description": "学校类型，如公办、民办"
},
"SchoolInCity": {
"type": "string",
"description": "高校所在地城市，不是考生所属招生地区。"
},
"CourseSelection": {
"type": "string",
"description": "选科要求"
},
"CourseSelectionName": {
"type": "string",
"description": "专业组"
},
"CoverImage": {
"type": "string",
"description": "高校 logo"
},
"Is985": {
"type": "boolean",
"description": "是否为 985 院校"
},
"Is211": {
"type": "boolean",
"description": "是否为 211 院校"
},
"IsDualClass": {
"type": "boolean",
"description": "是否为双一流院校"
},
"SubjectGroup": {
"type": "string",
"description": "专业组"
},
"DataUpdatedFrom": {
"type": "string",
"description": "资料采集日期，不是官方公告日期。"
}
},
"required": [
"DataId",
"Province",
"CollegeName",
"SchoolUUID",
"Year",
"HighestScore",
"AverageScore",
"LowestScore",
"LowestRank",
"ProvincialControlLine",
"EnrollmentType",
"SelectionLevel",
"AdmissionBatch",
"TypeName",
"SchoolType",
"SchoolInCity",
"CourseSelection",
"CourseSelectionName",
"CoverImage",
"Is985",
"Is211",
"IsDualClass",
"SubjectGroup",
"DataUpdatedFrom"
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
},
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
501
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "null",
"enum": [
null
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"enum": [
900
],
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
},
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
]
},
"Data": {
"type": "null",
"enum": [
null
],
"description": "当前页记录；DataTotalCount 是相同筛选条件的总数。"
}
},
"required": [
"DataStatus",
"Data"
]
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数缺失、非法、重复或冲突 | HTTP 400 |
| 900 | 处理、依赖失败或超时 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13