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&disciplineCategoryName=&lineScope=°reeType=&candidateRegion=&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 |
否 |
无 |
支持 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。 |
| 参数名 |
参数类型 |
备注 |
| 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 分的单科要求区分使用。 |
{
"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"
}
]
}