高考一分一段 API：分数查位次、科类枚举与历史对照

GuGuData 高考一分一段 API 按年份、省份和科类返回分数段人数、累计人数、位次范围及历史对照资料。查询指定分数时，可传 score；查询完整列表时，使用分页。接入前应先取得对应年份和省份的选科枚举，避免把不同考生群体的数据混在一起。

接口地址与用途

项目	内容
请求方法	GET
主接口	`https://api.gugudata.com/metadata/ceeline/one-score-one-section`
枚举接口	`https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums`
响应格式	JSON，UTF-8
主要用途	分数段人数查询、同口径位次展示、历史同分段与同位次资料对照

一分一段表描述特定年份、地区和科类的考生成绩分布。它不是院校录取分数线，也不是下一年的录取概率。当前文档提供 2016---2026 年可选年份，具体省份、科类和艺术类别的覆盖仍以实际响应为准。

请求参数

参数	类型	必填	默认值与含义
appkey	string	凭据必需	使用对应产品 AppKey，支持 Header 或 Query
year	string	是	查询年份，明确传入，例如 2026
provinceName	string	是	招生省份，例如上海、江苏
subjectSelection	string	是	当前年份和省份下的科类，从枚举接口读取
isArtLine	boolean	否	false；true 查询艺术类
artLineType	string	否	艺术类排名口径；isArtLine=true 时按枚举选择
pageIndex	integer	否	默认 1
pageSize	integer	否	默认 10，范围 1---100
score	number	否	按分数查分数段和位次，支持整数或小数；不传则返回分页列表

枚举接口需要 AppKey、year 和 provinceName，返回 Data.subjectSelection 与 Data.artLineType。普通类和艺术类应分别核对；艺术类的统考、综合或文化成绩排名不能相互代用。

cURL 调用示例

以下是文档示例，未使用真实凭据执行。先查询科类枚举：

bash 复制代码

curl --get 'https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'year=2026' \
  --data-urlencode 'provinceName=上海'

确认枚举中存在所需科类后，再查询该口径下的分数。例如官方公开示例提供上海综合类 500 分查询：

bash 复制代码

curl --get 'https://api.gugudata.com/metadata/ceeline/one-score-one-section' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'year=2026' \
  --data-urlencode 'provinceName=上海' \
  --data-urlencode 'subjectSelection=综合' \
  --data-urlencode 'score=500' \
  --data-urlencode 'pageIndex=1' \
  --data-urlencode 'pageSize=10'

AppKey 保存在服务端环境变量或密钥管理服务，不放进网页或公开仓库。中文参数使用 URL 编码；不要把示例省份和科类当作全国通用组合。

返回字段

字段	类型	说明
DataStatus.StatusCode	integer	业务状态码，100 表示成功
DataStatus.StatusDescription	string	状态说明
DataStatus.ResponseDateTime	string	响应时间，不等于数据更新时间
DataStatus.DataTotalCount	integer	当前筛选条件的匹配数量
Data.ExaminationScore	string	分数或分数段文字，保留原区间
Data.CandidateCount	integer	当前分数段人数
Data.TotalCandidates	integer	截至该分数段的累计人数
Data.RankingRange	string	位次范围，可能为区间文字
Data.AdmissionBatchName	string	相关录取批次名称
Data.MinimumAdmissionScore	string	最低录取控制分数资料
Data.Ranking	string	位次
Data.HistoricalScores	array	历年同分段资料
Data.HistoricalSameRankScores	array	历史同位次分数资料

CandidateCount 与 TotalCandidates 分别表示分数段人数和累计人数，不能相加作为另一项人数。RankingRange 可能是区间，不能直接按一个整数解析。

HistoricalSameRankScores 在同省、同科类的历史位次区间中匹配。无匹配时返回空数组，不代表该年份没有考生；也不表示同位次考生在不同年份拥有相同录取结果。

错误和空结果

HTTP 成功与业务成功分开判断。HTTP 200 后仍需检查 DataStatus.StatusCode；业务码 101 对应参数问题、102 对应请求受限、103 对应账号权益、104 对应 AppKey 问题。限流以当前套餐和接口文档为准，不沿用旧文的 100 QPS 描述。

空结果先核对 year、provinceName、subjectSelection 和艺术类条件，再核对 score 与分页。不要把鉴权失败、错误科类或越界页显示成"该分数没有考生"。

使用范围与官方资料

该接口适合一分一段数据展示与历史资料核对。跨年比较要说明政策、科类与人数口径变化；实际报考仍以当年省级考试院和院校公告为准。

本文由 GuGuData 产品方整理，核对日期为 2026 年 11 月 1 日。示例中的 YOUR_APPKEY 是占位符，服务权益和当前覆盖以官方说明及实际响应为准。