研究生招生目录 API：学校筛选、考试科目与招生备注

GuGuData 研究生招生专业目录 API 查询招生单位、院系、专业、研究方向、考试科目和拟招生人数资料。请求使用 GET，按招生年份与学校等条件筛选。招生目录描述报考信息，不等同于国家线、学校复试线或最终录取人数。

接口概览

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

请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	否	无	支持 Query、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；相同值可共存，冲突返回 501。
year	integer	否	2026	招生年份，默认 2026；正 Int32 整数。其他合法年份无数据时返回空数组，空值及非法值返回 501。
schooluuid	string	否	无	关联高校 ID 精确匹配，未关联的记录不推断补写；默认不筛选。
schoolcode	string	否	无	招生单位代码精确匹配；作为字符串传入，保留前导零；默认不筛选。
schoolname	string	否	无	招生单位名称关键词；默认不筛选。
province	string	否	无	招生单位所在省份关键词；默认不筛选。
majorcode	string	否	无	专业代码精确匹配，例如 010101；作为字符串传入，保留前导零；默认不筛选。
majorname	string	否	无	专业名称关键词；默认不筛选。
degreeType	string	否	无	学位类型，支持所列中英文别名，英文不区分大小写；空值或未传不筛选。
studyMode	string	否	无	学习方式，支持所列中英文别名，英文不区分大小写；空值或未传不筛选。
isDoubleFirstClass	boolean	否	无	双一流条件；支持 true/false、1/0、yes/no、是/否。空值或未传不筛选，不默认为 false。
isSelfMarking	boolean	否	无	自主划线条件；支持 true/false、1/0、yes/no、是/否。空值或未传不筛选，不默认为 false。
pageindex	integer	否	1	页码从 1 开始，超出结果范围返回空数组及完整匹配总数。
pagesize	integer	否	10	每页 1～20 条，默认 10。

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

请求示例

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

curl --get 'https://api.gugudata.com/metadata/postgraduate-program' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'year=2026' \
  --data-urlencode 'schoolname=北京大学' \
  --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.SchoolUUID	string	关联高校的唯一标识；未关联时为空字符串，不据此推断招生单位不存在。
Data.SchoolCode	string	招生单位代码；对应 Data 数组中的一条记录。
Data.SchoolName	string	招生单位名称；对应 Data 数组中的一条记录。
Data.Province	string	招生单位所在省份；对应 Data 数组中的一条记录。
Data.City	string	招生单位所在城市；对应 Data 数组中的一条记录。
Data.CoverImage	string	学校封面图或校徽图片；对应 Data 数组中的一条记录。
Data.IsDoubleFirstClass	boolean	是否为双一流建设高校；对应 Data 数组中的一条记录。
Data.HasGraduateSchool	boolean	是否设有研究生院；对应 Data 数组中的一条记录。
Data.IsSelfMarking	boolean	是否为自主划线招生单位；对应 Data 数组中的一条记录。
Data.DepartmentName	string	院系名称；对应 Data 数组中的一条记录。
Data.MajorCode	string	专业代码；对应 Data 数组中的一条记录。
Data.MajorName	string	专业名称；对应 Data 数组中的一条记录。
Data.DegreeType	string	学位类型；对应 Data 数组中的一条记录。
Data.DisciplineCategoryCode	string	门类代码；对应 Data 数组中的一条记录。
Data.DisciplineCategoryName	string	门类名称；对应 Data 数组中的一条记录。
Data.FirstLevelDisciplineCode	string	一级学科或专业学位类别代码；对应 Data 数组中的一条记录。
Data.FirstLevelDisciplineName	string	一级学科或专业学位类别名称；对应 Data 数组中的一条记录。
Data.DirectionName	string	研究方向名称；对应 Data 数组中的一条记录。
Data.StudyMode	string	学习方式；对应 Data 数组中的一条记录。
Data.ExamMethod	string	考试方式；对应 Data 数组中的一条记录。
Data.Advisor	string	该目录记录提供的导师资料；为空表示未提供，不代表该专业没有导师。
Data.PlannedEnrollmentText	string	该招生目录的拟招生人数原文；可能包含院系或专业层面的说明，不代表每个研究方向分别拥有此人数。
Data.Remark	string	专业备注；对应 Data 数组中的一条记录。
Data.ExamSubjectGroups	array	该方向的考试科目组合列表；每组包含 Subject1 至 Subject4 的代码、名称和说明，空资料不代表免考。
Data.BrochureTitle	string	招生简章标题；对应 Data 数组中的一条记录。
Data.BrochurePublishedDate	string	招生简章发布日期；对应 Data 数组中的一条记录。
Data.BrochureSummary	string	招生简章摘要；对应 Data 数组中的一条记录。

字段口径与使用边界

SchoolCode 为招生单位代码，SchoolUUID 为可靠关联到高校基础信息后的平台标识；无法关联时为空，不要凭同名院校补造 ID。PlannedEnrollmentText 是原始招生人数文本，可能含说明，不能直接当作确定的整数。一个专业方向可有多组 ExamSubjectGroups，应保留组内科目关系，不把不同组的科目任意拼接。BrochurePublishedDate 是简章发布日期，Year 是招生年份，两者不能混用；简章字段缺失也不代表学校未发布简章。

错误与结果核对

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

查询时明确招生年份，并核对学校、院系、专业代码、方向和学习方式。展示考试科目组及招生备注原文；实际报考条件、专业调整和人数变化以该校对应年份的正式招生简章为准。

官方文档与预览

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

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