API 文档
接口地址: 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&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 |
是 |
无 |
正式接口必须使用在咕咕数据开发者中心获取的对应 AppKey。推荐通过 X-GUGUDATA-APPKEY 请求头传递,也支持 AppKey、X-API-Key 和 Authorization: Bearer。未通过请求头传递时,请填写 Query 参数 appkey。多处同时传递时取值必须一致,冲突返回业务码 501。 |
| year |
integer |
否 |
2026 |
考试年份,一次查询一年。省略时默认 2026,取值为 2001 至 2026 的整数。传空值、非整数或超出范围时返回业务码 501。 |
| disciplineCategoryName |
string |
否 |
不筛选 |
按学科门类、专业学位类别、专项计划或照顾政策名称做关键词匹配,例如「哲学」。留空时查询所有类别。 |
| lineScope |
string |
否 |
不筛选 |
国家线类型。常用值为 unified(按学科门类统一划线)、separate(单独划线)、special(专项计划和照顾政策)、academic(学术学位)、professional(专业学位)。支持对应的 national_ 前缀值及「统一划线」「单独划线」「专项计划」「学术学位」「专业学位」等中文别名。英文不区分大小写。留空时查询所有类型。 |
| degreeType |
string |
否 |
不筛选 |
按数据中已有的学位类型筛选。学术学位传 academic 或学术学位,专业学位传 professional 或专业学位。留空时不按学位类型筛选。2026 年查统一划线时可省略此参数,传 academic 会匹配不到记录。 |
| candidateRegion |
string |
否 |
不筛选 |
按招生单位所在地区筛选国家线。一区可传 A、A区或一区,二区可传 B、B区或二区。查询 C 区、应届生、往届生等历史分类时,使用对应年份返回的 CandidateRegion 原值。留空时查询所有地区及历史分类。 |
| pageindex |
integer |
否 |
1 |
结果页码,从 1 开始,省略时默认 1。页码超出结果范围时,Data 返回空数组,DataStatus.DataTotalCount 仍为全部匹配数。 |
| pagesize |
integer |
否 |
10 |
每页最多返回的记录数,取值为 1 至 20 的整数,省略时默认 10。实际返回条数取决于该页剩余的匹配记录。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
业务请求摘要。正式接口返回包含实际年份、筛选条件和分页值的 JSON 字符串,鉴权凭据不会出现在摘要中。Demo 返回固定示例的查询字符串。业务参数校验失败时可能为空。 |
| DataStatus.StatusCode |
integer |
业务状态码。100 表示查询成功,包括没有匹配记录的情况。其他状态结合 HTTP 状态和 StatusDescription 判断。 |
| DataStatus.StatusDescription |
string |
业务状态说明。查询失败时可用此字段查看失败原因,程序按 StatusCode 处理。 |
| DataStatus.ResponseDateTime |
string |
服务端生成本次响应的时间,格式为 yyyy-MM-dd HH:mm:ss.fff。 |
| DataStatus.DataTotalCount |
integer |
当前筛选条件下的全部匹配记录数,分页前计数。无匹配或查询失败时为 0。页码超出结果范围时仍返回实际匹配总数。 |
| Data.Year |
integer |
该条国家线对应的考试年份,与本次请求实际查询的年份一致。 |
| Data.LineScope |
string |
该条国家线类型的中文名称,例如「国家线-按学科门类统一划线」或「国家线-专项计划和照顾政策」。 |
| Data.DisciplineCategoryName |
string |
该条国家线适用的学科门类、专业学位类别、专项计划或照顾政策名称,例如「哲学」。 |
| Data.CandidateRegion |
string |
该条国家线适用的考生区域或历史分类,例如「A区」「B区」或「应届生」。对照历年数据时使用返回的原值。 |
| Data.TotalScore |
integer |
该年份、国家线类型、学科或专业及考生地区下的总分控制线,单位为分。具体复试要求以报考招生单位当年公告为准。 |
| Data.SingleSubject100Text |
string |
满分为 100 分的科目对应的单科控制线原文。可返回「41」等数字字符串或「招生单位自主确定」等说明,按原文展示。 |
| Data.SingleSubjectOver100Text |
string |
满分超过 100 分的科目对应的单科控制线原文,可返回「62」等数字字符串。历史记录中的空字符串按原值返回。 |
{
"DataStatus": {
"RequestParameter": "year=2026&disciplineCategoryName=哲学&lineScope=国家线-按学科门类统一划线°reeType=&candidateRegion=&pageindex=1&pagesize=10",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-09-07 12:00:00",
"DataTotalCount": 2
},
"Data": [
{
"Year": 2026,
"LineScope": "国家线-按学科门类统一划线",
"DisciplineCategoryName": "哲学",
"CandidateRegion": "A区",
"TotalScore": 326,
"SingleSubject100Text": "41",
"SingleSubjectOver100Text": "62"
},
{
"Year": 2026,
"LineScope": "国家线-按学科门类统一划线",
"DisciplineCategoryName": "哲学",
"CandidateRegion": "B区",
"TotalScore": 316,
"SingleSubject100Text": "38",
"SingleSubjectOver100Text": "57"
}
]
}