考研国家线 API：年份、A/B 区与单科要求

GuGuData 研究生招生国家分数线 API 按考试年份、学科分类、国家线类型、学位类型和考生区域查询总分与单科要求。请求使用 GET；本接口只提供国家线，不包含学校复试线或院系专业线。

接口概览

项目	说明
请求方法	GET
接口地址	https://api.gugudata.com/metadata/postgraduate-national-score-line
返回格式	JSON，UTF-8
调用凭据	对应产品有效 AppKey，示例通过 Header 传递

请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	否	无	支持 Query、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；相同值可共存，冲突返回 501。
year	integer	否	2026	考试年份，2001—2026；超出范围或非整数返回 501。
disciplineCategoryName	string	否	无	学科门类、专业类别或政策名称关键词；默认不筛选。
lineScope	string	否	无	国家线类型；接受所列中文及英文别名，英文不区分大小写；默认不筛选。
degreeType	string	否	无	仅筛选原有学位分类，不推断分类；2026 年 academic 无匹配。默认不筛选。
candidateRegion	string	否	无	A/A区/一区、B/B区/二区支持别名；C区、应届生、往届生及历史复合分类按返回值原样筛选。默认不筛选。
pageindex	integer	否	1	页码从 1 开始，超出结果范围返回空数组及完整匹配总数。
pagesize	integer	否	10	每页 1～20 条，默认 10。

参数名与大小写按当前文档传递，筛选条件和年份覆盖以实际响应为准。不要把文档示例值当作所有年份或地区通用的业务规则。

请求示例

以下为文档示例，未使用真实凭据执行。YOUR_APPKEY 是占位符，正式调用需要对应产品的有效凭据及权益；价格与套餐以官网为准。中文查询参数使用 URL 编码。

curl --get 'https://api.gugudata.com/metadata/postgraduate-national-score-line' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'year=2026' \
  --data-urlencode 'disciplineCategoryName=哲学' \
  --data-urlencode 'candidateRegion=A区' \
  --data-urlencode 'pageindex=1' \
  --data-urlencode 'pagesize=10'

返回字段

参数名	参数类型	备注
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	筛选后的全部匹配数量，失败为 0。
Data.Year	integer	考试年份；对应 Data 数组中的一条记录。
Data.LineScope	string	国家线层级或类型中文名称；对应 Data 数组中的一条记录。
Data.DisciplineCategoryName	string	学科门类、专业学位类别、专项计划或照顾政策名称；对应 Data 数组中的一条记录。
Data.CandidateRegion	string	考生区域或历史考生分类；对应 Data 数组中的一条记录。
Data.TotalScore	integer	该年份、国家线类型、学科或专业及考生地区下的总分控制线；不是招生单位自行公布的复试线。
Data.SingleSubject100Text	string	满分为 100 分的单科控制线原文；保留数字及自主确定等文字说明，不直接强制转换为整数。
Data.SingleSubjectOver100Text	string	满分大于 100 分的单科控制线原文；与满分 100 分的单科要求区分使用。

字段口径与使用边界

截至 2026 年 11 月 3 日核对，接口文档标明年份范围为 2001～2026，默认查询 2026 年。这是接口覆盖范围，不表示所有年份、分类和筛选组合均有记录。本文未核实逐条记录的原始公告链接及固定更新周期；用于报考判断时，应与教育部当年国家线公告及招生单位要求交叉核对，不能以 ResponseDateTime 代替公告发布日期。

不同年份的国家线结构与考生分类可能不同，lineScope 与 CandidateRegion 应按对应年份的实际返回值理解，不把所有历史记录强行归为当前 A/B 区。SingleSubject100Text 与 SingleSubjectOver100Text 分别是两种单科满分口径的要求，保留文字说明，不把“招生单位自主确定”等内容转换为 0。专项计划、照顾政策与常规学科线分别筛选，不能只比较 TotalScore 就判断个人是否满足复试或录取条件。

错误与结果核对

先检查 HTTP 状态，再检查 DataStatus.StatusCode；100 表示业务成功。鉴权、参数、限流与服务异常分别处理，不把失败响应转换成“没有数据”。接口响应时间不等于数据更新时间；空值保留缺口，不补造为零。错误码和 QPS 以当前文档与订单为准。

查询时明确年份、学科分类、划线类型和适用考生区域；同时展示总分、两类单科要求及特殊文字说明。达到国家线不等于达到院校复试线，更不代表最终录取。

官方文档与预览

• 完整接口文档
• 公开数据预览
• 接口 Demo

本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 3 日。用于接口集成与资料核对，实际政策、申请及招生要求以相关机构正式公告为准。