研究生招生国家分数线 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/postgraduatenationalscoreline

研究生招生国家分数线 API 提供 2001—2026 年全国硕士研究生招生考试国家线数据，支持按考试年份、学科分类、国家线类型、学位类型和考生地区或历史考生分类筛选，返回总分与单科要求。适合用于考研信息查询、历年分数线对比、院校专业分析、招生数据看板和业务检索等场景。

gugudata_api_cover

1. 产品功能

连续覆盖 2001—2026 年研究生招生考试国家线；各年份的划线结构不同，以该年份实际返回的 lineScope 和 CandidateRegion 为准；
支持按考试年份查询国家线，便于构建历年国家线检索、趋势展示和对比分析；
支持按学科门类或专项名称关键词筛选，例如哲学、经济学、法学、教育学、少数民族照顾政策等；
支持国家线类型筛选，可区分按学科门类统一划线、单独划线学科专业，以及不同年份的学术学位、专业学位、专项计划和照顾政策等类型；
支持按学位类型筛选，可用于区分学术学位和专业学位国家线；
支持按考生区域或历史考生分类筛选，A、A区、一区和 B、B区、二区可互换；C 区、应届生、往届生等历史口径应按接口返回值原样传递；
返回总分要求、满分等于 100 分的单科要求、满分大于 100 分的单科要求；
支持分页查询，适合批量同步、表格展示和检索结果页接入；
明确仅包含国家线，不包含学校复试线或院系学科线，便于业务侧准确标注数据范围；
2025、2026 年专项记录按学科分类与政策类型结构化：少数民族高层次骨干人才计划的单科要求标注为招生单位自主确定，享受少数民族照顾政策的单科要求为 30 分和 45 分；
接口使用 HTTPS，请以公开文档和实际响应为准；

接口地址: https://api.gugudata.com/metadata/postgraduate-national-score-line

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/metadata/postgraduate-national-score-line?appkey=YOUR_APPKEY&year=2026&disciplineCategoryName=哲学&lineScope=national_unified&degreeType=academic&candidateRegion=A区&pageindex=1&pagesize=10

数据预览: https://www.gugudata.com/preview/postgraduatenationalscoreline

接口测试: https://api.gugudata.com/metadata/postgraduate-national-score-line/demo

OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
year	int	否	2026	考试年份，支持 2001—2026；不传时默认查询 2026 年
disciplineCategoryName	string	否	哲学	学科门类或专项名称关键词，如哲学、经济学、管理学、专项计划等
lineScope	string	否	national_unified	国家线类型，支持 national_unified、national_separate、national_special、national_academic、national_professional，也支持对应中文名称
degreeType	string	否	academic	学位类型，支持 academic、professional、学术学位、专业学位
candidateRegion	string	否	A区	考生区域或历史考生分类；A/一区、B/二区支持别名，C区及应届生、往届生等历史值需按返回值原样传递
pageindex	int	否	1	分页参数，第几页，从 1 开始
pagesize	int	否	10	分页参数，每页条数，取值范围 1 ~ 20

参数名	参数类型	备注
DataStatus.RequestParameter	string	本次请求的参数摘要，不包含 APPKEY
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
Data.Year	int	考试年份
Data.LineScope	string	国家线类型中文名称
Data.DisciplineCategoryName	string	学科门类或专项名称
Data.CandidateRegion	string	考生区域，如 A区、B区
Data.TotalScore	int	总分要求
Data.SingleSubject100Text	string	满分等于 100 分的单科分数要求
Data.SingleSubjectOver100Text	string	满分大于 100 分的单科分数要求

状态码	错误说明	备注
100	正常返回	可通过判断此状态码断言接口正常返回
-1	请求失败	请求处理失败，请检查请求后重试
501	参数错误	请检查传递的参数个数、取值范围和参数类型是否匹配
502	请求频率受限	默认情况下，每个接口提供 5 QPS 并发能力。超出当前并发能力时，网关可能返回 429；如需更高吞吐，可按需购买额外 QPS 扩展包
503	APPKEY 权限超限或订单到期	请前往开发者中心检查 APPKEY 状态与订单有效期
504	APPKEY 错误	请检查传递的 APPKEY 是否正确
505	请求次数超出接口限制	请检查接口剩余请求次数与配额限制
900	接口内部响应错误	接口服务暂时不可用，请稍后重试