研究生招生专业目录 API 接口接口详情官网地址:https://www.gugudata.com/api/details/postgraduateprogram研究生招生专业目录 API 支持查询研究生招生单位、院系、专业、研究方向、考试科目、拟招生人数和招生简章摘要等数据覆盖招生年份、学校、专业、学位类型、学习方式、双一流高校、自主划线单位等筛选条件。基础数据、研究生招生、考研择校、招生目录检索等关键词场景常会用到适合用于教育数据平台、考研信息工具、院校专业库、招生简章聚合和业务检索等场景方便开发者直接在应用、脚本或数据流程中接入。1. 产品功能支持查询研究生招生专业目录返回招生单位、院系、专业、研究方向和学习方式等结构化字段支持按招生年份、学校唯一 ID、学校代码、学校名称、省份、专业代码、专业名称等条件筛选支持按学位类型筛选可用于区分学术学位和专业学位招生目录支持按学习方式筛选可用于区分全日制和非全日制专业方向支持双一流建设高校、设有研究生院、自主划线招生单位等学校特征字段返回考试科目组包含思想政治理论、外语、业务课一、业务课二等科目代码、名称和说明返回拟招生人数文本、导师信息、专业备注、招生简章标题、发布日期和摘要等辅助信息返回学校封面图或校徽图片可用于产品页面、列表页和详情页展示支持分页查询便于在后台任务、搜索页、筛选器和数据看板中稳定接入全接口支持 HTTPSTLS v1.0 / v1.1 / v1.2 / v1.3全面兼容 Apple ATS全国多节点 CDN 部署接口极速响应多台服务器构建 API 接口负载均衡2. API 文档接口地址:https://api.gugudata.com/metadata/postgraduate-program返回格式:application/json; charsetutf-8请求方式:GET请求协议:HTTPS请求示例:https://api.gugudata.com/metadata/postgraduate-program?appkeyYOUR_APPKEYyear2026schooluuidYOUR_VALUEschoolcode10001schoolname北京大学province北京majorcode010101majorname哲学degreeTypeacademicstudyModefull_timeisDoubleFirstClasstrueisSelfMarkingtruepageindex1pagesize10数据预览:https://www.gugudata.com/preview/postgraduateprogram接口测试:https://api.gugudata.com/metadata/postgraduate-program/demoOpenAPI:https://www.gugudata.com/openapi/gugudata.openapi.3.1.json3. 请求参数参数名参数类型是否必须默认值备注appkeystring是YOUR_APPKEY付费后获取的 APPKEYyearint否2026招生年份如 2024、2025、2026。不传时默认查询当前可用招生年份schooluuidstring否YOUR_VALUE咕咕数据平台高校唯一 ID可与全国大学高校基础信息接口关联schoolcodestring否10001招生单位代码如北京大学为 10001schoolnamestring否北京大学招生单位名称关键词支持按学校名称检索provincestring否北京招生单位所在省份名称如北京、江苏、上海、广东等majorcodestring否010101专业代码如 010101majornamestring否哲学专业名称关键词如哲学、计算机、金融等degreeTypestring否academic学位类型支持 academic、professional、学术学位、专业学位studyModestring否full_time学习方式支持 full_time、part_time、全日制、非全日制isDoubleFirstClassboolean否true是否筛选双一流建设高校isSelfMarkingboolean否true是否筛选自主划线招生单位pageindexint否1分页参数第几页从 1 开始pagesizeint否10分页参数每页条数取值范围 1 ~ 204. 返回参数参数名参数类型备注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 顾问适合为教育类应用补充问答式咨询能力。