历年高考一分一段数据
GET
https://api.gugudata.com/metadata/ceeline/one-score-one-section
GET /metadata/ceeline/one-score-one-section业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| year | query | string | 是 | 无 | 查询年份。当前可选值：2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| provinceName | query | string | 是 | 无 | 招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| subjectSelection | query | string | 是 | 无 | 科目选择类型筛选。当前全部可选值（共 5 项）：综合、历史类、物理类、文科、理科。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考一分一段数据-查询参数枚举（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.subjectSelection。 |
| isArtLine | query | boolean | 否 | false | 是否查询艺术类一分一段数据；true 表示查询艺术类，false 或不传表示查询普通类。 |
| artLineType | query | string | 否 | 统考成绩排名 | 艺术类分数线类型，isArtLine=true 时可传。当前全部可选值（共 3 项）：统考成绩排名、综合成绩排名、文化成绩排名。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考一分一段数据-查询参数枚举（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.artLineType。 |
| pageIndex | query | integer | 否 | 1 | 分页参数，第几页，默认值为1 |
| pageSize | query | integer | 否 | 10 | 分页参数，每页条数，取值范围在 1 ~ 100 之间（含） |
| score | query | string | 否 | 无 | 按高考分数查询对应分数段和位次，支持整数或小数；为空时返回分页列表。 |
独立请求示例
{
"year": "2026",
"provinceName": "江苏",
"subjectSelection": "物理类",
"pageIndex": 1,
"pageSize": 10
}返回契约
application/json{
"oneOf": [
{
"type": "object",
"required": [
"DataStatus",
"Data"
],
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "array",
"items": {
"type": "object",
"required": [
"ExaminationScore",
"RankingRange",
"AdmissionBatchName",
"MinimumAdmissionScore",
"Ranking",
"ScoreType",
"SpecialCategory",
"LevelName",
"TypeName",
"CandidateCount",
"TotalCandidates",
"MinScore",
"MaxScore",
"HistoricalScores",
"HistoricalSameRankScores"
],
"properties": {
"ExaminationScore": {
"type": "string",
"description": "高考分数"
},
"RankingRange": {
"type": "string",
"description": "该分数段对应的位次范围；可能为区间文字，不应直接按单个整数解析。"
},
"AdmissionBatchName": {
"type": [
"string",
"null"
],
"description": "录取批次名称"
},
"MinimumAdmissionScore": {
"type": [
"string",
"null"
],
"description": "最低录取控制分数线"
},
"Ranking": {
"type": [
"string",
"null"
],
"description": "位次"
},
"ScoreType": {
"type": [
"string",
"null"
],
"description": "艺术成绩类型；普通类可能为 null。"
},
"SpecialCategory": {
"type": [
"string",
"null"
],
"description": "艺术专业类别，可能为空或 null。"
},
"LevelName": {
"type": [
"string",
"null"
],
"description": "来源层次名称，可能为空或 null。"
},
"TypeName": {
"type": [
"string",
"null"
],
"description": "沿用来源艺术类型说明，可能为空或 null；不保证可据此区分艺术查询中所有科类。"
},
"CandidateCount": {
"type": "integer",
"description": "该分数或分数段内的考生人数，与累计人数 TotalCandidates 区分。"
},
"TotalCandidates": {
"type": "integer",
"description": "截至该分数段的累计考生人数；应在同年份、同省份、同科类口径下对照。"
},
"MinScore": {
"type": "integer",
"description": "既有艺术类辅助整数边界；普通类或非整数边界保留原有 0 表达，不代表官方零分。"
},
"MaxScore": {
"type": "integer",
"description": "既有艺术类辅助整数边界，说明同 MinScore。"
},
"HistoricalScores": {
"type": "array",
"items": {
"type": "object",
"required": [
"AcademicYear",
"ExaminationScore",
"RankingRange"
],
"properties": {
"AcademicYear": {
"type": "integer",
"description": "历史资料年份。"
},
"ExaminationScore": {
"type": "string",
"description": "该年份的参考分值或区间文本。"
},
"RankingRange": {
"type": "string",
"description": "对应的历史来源位次区间。"
}
},
"additionalProperties": false,
"description": "历年同分段数据"
},
"description": "历年同分段数据"
},
"HistoricalSameRankScores": {
"type": "array",
"items": {
"type": "object",
"required": [
"AcademicYear",
"ExaminationScore",
"RankingRange"
],
"properties": {
"AcademicYear": {
"type": "integer",
"description": "历史资料年份。"
},
"ExaminationScore": {
"type": "string",
"description": "该年份的参考分值或区间文本。"
},
"RankingRange": {
"type": "string",
"description": "对应的历史来源位次区间。"
}
},
"additionalProperties": false,
"description": "历史同位次分数列表；以当前位次范围上界（无范围时使用 Ranking）在同省、同科类往年位次区间中匹配，返回命中的年份、分数段及位次范围。无匹配时为空数组，不代表该年份没有考生。"
},
"description": "历史同位次分数列表；以当前位次范围上界（无范围时使用 Ranking）在同省、同科类往年位次区间中匹配，返回命中的年份、分数段及位次范围。无匹配时为空数组，不代表该年份没有考生。"
}
},
"additionalProperties": false,
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
},
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
},
{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
}
]
}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",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 200 |
| 900 | 依赖失败 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13