研究生招生专业目录 API 接口

研究生招生专业目录 API 接口

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

研究生招生专业目录 API 支持查询研究生招生单位、院系、专业、研究方向、考试科目、拟招生人数和招生简章摘要等数据,覆盖招生年份、学校、专业、学位类型、学习方式、双一流高校、自主划线单位等筛选条件。基础数据、研究生招生、考研择校、招生目录检索等关键词场景常会用到,适合用于教育数据平台、考研信息工具、院校专业库、招生简章聚合和业务检索等场景,方便开发者直接在应用、脚本或数据流程中接入。

1. 产品功能

  • 支持查询研究生招生专业目录,返回招生单位、院系、专业、研究方向和学习方式等结构化字段;
  • 支持按招生年份、学校唯一 ID、学校代码、学校名称、省份、专业代码、专业名称等条件筛选;
  • 支持按学位类型筛选,可用于区分学术学位和专业学位招生目录;
  • 支持按学习方式筛选,可用于区分全日制和非全日制专业方向;
  • 支持双一流建设高校、设有研究生院、自主划线招生单位等学校特征字段;
  • 返回考试科目组,包含思想政治理论、外语、业务课一、业务课二等科目代码、名称和说明;
  • 返回拟招生人数文本、导师信息、专业备注、招生简章标题、发布日期和摘要等辅助信息;
  • 返回学校封面图或校徽图片,可用于产品页面、列表页和详情页展示;
  • 支持分页查询,便于在后台任务、搜索页、筛选器和数据看板中稳定接入;
  • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
  • 全面兼容 Apple ATS;
  • 全国多节点 CDN 部署;
  • 接口极速响应,多台服务器构建 API 接口负载均衡;

2. API 文档

接口地址:https://api.gugudata.com/metadata/postgraduate-program

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

请求方式:GET

请求协议:HTTPS

请求示例:https://api.gugudata.com/metadata/postgraduate-program?appkey=YOUR_APPKEY&year=2026&schooluuid=YOUR_VALUE&schoolcode=10001&schoolname=北京大学&province=北京&majorcode=010101&majorname=哲学&degreeType=academic&studyMode=full_time&isDoubleFirstClass=true&isSelfMarking=true&pageindex=1&pagesize=10

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

接口测试:https://api.gugudata.com/metadata/postgraduate-program/demo

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

3. 请求参数

参数名参数类型是否必须默认值备注
appkeystringYOUR_APPKEY付费后获取的 APPKEY
yearint2026招生年份,如 2024、2025、2026。不传时默认查询当前可用招生年份
schooluuidstringYOUR_VALUE咕咕数据平台高校唯一 ID,可与全国大学高校基础信息接口关联
schoolcodestring10001招生单位代码,如北京大学为 10001
schoolnamestring北京大学招生单位名称关键词,支持按学校名称检索
provincestring北京招生单位所在省份名称,如北京、江苏、上海、广东等
majorcodestring010101专业代码,如 010101
majornamestring哲学专业名称关键词,如哲学、计算机、金融等
degreeTypestringacademic学位类型,支持 academic、professional、学术学位、专业学位
studyModestringfull_time学习方式,支持 full_time、part_time、全日制、非全日制
isDoubleFirstClassbooleantrue是否筛选双一流建设高校
isSelfMarkingbooleantrue是否筛选自主划线招生单位
pageindexint1分页参数,第几页,从 1 开始
pagesizeint10分页参数,每页条数,取值范围 1 ~ 20

4. 返回参数

参数名参数类型备注
DataStatus.StatusCodeint接口返回状态码
DataStatus.StatusDescriptionstring接口返回状态说明
DataStatus.ResponseDateTimestring接口数据返回时间
DataStatus.DataTotalCountint此条件下的总数据量,一般用于分页计算
Data.Yearint招生年份
Data.SchoolUUIDstring咕咕数据平台高校唯一 ID,无法可靠关联时为空
Data.SchoolCodestring招生单位代码
Data.SchoolNamestring招生单位名称
Data.Provincestring招生单位所在省份
Data.Citystring招生单位所在城市
Data.CoverImagestring学校封面图或校徽图片
Data.IsDoubleFirstClassboolean是否为双一流建设高校
Data.HasGraduateSchoolboolean是否设有研究生院
Data.IsSelfMarkingboolean是否为自主划线招生单位
Data.DepartmentNamestring院系名称
Data.MajorCodestring专业代码
Data.MajorNamestring专业名称
Data.DegreeTypestring学位类型,例如学术学位、专业学位
Data.DisciplineCategoryCodestring门类代码
Data.DisciplineCategoryNamestring门类名称
Data.FirstLevelDisciplineCodestring一级学科或专业学位类别代码
Data.FirstLevelDisciplineNamestring一级学科或专业学位类别名称
Data.DirectionNamestring研究方向名称
Data.StudyModestring学习方式,例如全日制、非全日制
Data.ExamMethodstring考试方式
Data.Advisorstring导师信息
Data.PlannedEnrollmentTextstring拟招生人数文本
Data.Remarkstring专业备注
Data.ExamSubjectGroupsarray考试科目组,一个专业方向可能包含多组可选考试科目
Data.ExamSubjectGroups[].Subject1.Codestring第一科考试科目代码
Data.ExamSubjectGroups[].Subject1.Namestring第一科考试科目名称
Data.ExamSubjectGroups[].Subject1.Descriptionstring第一科考试科目说明
Data.ExamSubjectGroups[].Subject2.Codestring第二科考试科目代码
Data.ExamSubjectGroups[].Subject2.Namestring第二科考试科目名称
Data.ExamSubjectGroups[].Subject2.Descriptionstring第二科考试科目说明
Data.ExamSubjectGroups[].Subject3.Codestring第三科考试科目代码
Data.ExamSubjectGroups[].Subject3.Namestring第三科考试科目名称
Data.ExamSubjectGroups[].Subject3.Descriptionstring第三科考试科目说明
Data.ExamSubjectGroups[].Subject4.Codestring第四科考试科目代码
Data.ExamSubjectGroups[].Subject4.Namestring第四科考试科目名称
Data.ExamSubjectGroups[].Subject4.Descriptionstring第四科考试科目说明
Data.BrochureTitlestring招生简章标题
Data.BrochurePublishedDatestring招生简章发布日期
Data.BrochureSummarystring招生简章摘要
Data.DataUpdatedFromstring数据更新时间

5. 错误码说明

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

6. 适用场景

  • 适合用于考研择校产品,快速按学校、专业、院系、研究方向和考试科目组织招生目录。
  • 适合用于教育数据平台和高校信息库,将研究生招生目录与高校基础信息、地区、省份和学校特征字段关联展示。
  • 适合用于招生简章聚合、专业库检索、考试科目对比、全日制/非全日制筛选和自主划线高校筛选。
  • 适合用于数据看板和内部运营工具,按年份、省份、学校类型、专业名称和学位类型统计招生方向分布。
  • 适合用于和研究生招生国家分数线组合,构建从“招生目录查询”到“国家线参考”的完整考研信息链路。

7. 相关接口

  • 可搭配使用:研究生招生国家分数线,适合补充国家线、A/B 区、总分和单科分数要求。
  • 可搭配使用:全国大学高校基础信息,适合补充学校基本信息、所在地、办学层次和高校特征。
  • 可搭配使用:学科专业目录,适合补充专业门类、专业名称和专业代码基础字段。
  • 可搭配使用:基于模型的高校录取概率预测,适合在教育产品中扩展高考录取概率预测能力。
  • 可搭配使用:高考志愿填报 AI 顾问,适合为教育类应用补充问答式咨询能力。