全国高考数据查询

正常 NEW

全国高考数据查询，涵盖分数线/高校/专业/录取/位次/志愿推荐。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1845次

¥ 0.004 / 次

按次计费

购买次数包更优惠，低至 0.0032 元/次

100次调用包 100 次调用 ¥0.0040 /次

500次调用包 500 次调用 ¥0.0038 /次省 5%

1000次调用包 1,000 次调用 ¥0.0036 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.0034 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0032 /次省 20%

健康检查

服务存活探测

服务存活探测接口，返回服务版本、数据时间与各数据集说明，可用于健康检查。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.version	string	数据版本
data.time	string	数据时间（UTC）
data.datasets	object	数据集说明
data.datasets.university	string	高校
data.datasets.score	string	投档线数据说明
data.datasets.segment	string	一分一段数据说明
data.datasets.discipline	string	学科
data.datasets.dorm	string	宿舍数据说明
data.datasets.career	string	职业方向
data.datasets.city_industry	string	城市产业数据说明
data.batch_limit	integer	批量查询允许的最大条数

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-22 14:47:33","version":"1.0","datasets":{"dorm":"高校宿舍信息","score":"各省投档线","career":"霍兰德性格-职业-专业","segment":"一分一段表","discipline":"学科评估 (第四轮+第五轮)","university":"全国高校 (多源融合)","city_industry":"城市-产业-专业-企业"},"batch_limit":10}}

高校字段列表

返回高校可查询字段

返回高校数据支持的全部字段名、字段标签说明以及精简字段列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-fields JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.fields	array	字段名列表
data.fields[]	string	字段名
data.labels	object	字段标签说明
data.labels.id	string	唯一标识
data.labels.school_code	string	院校代码
data.labels.school_id_code	string	学校标识码
data.labels.name	string	名称
data.labels.short	string	简称
data.labels.old_name	string	曾用名
data.labels.type_name	string	类型名称
data.labels.school_type_name	string	办学层次
data.labels.school_nature_name	string	办学性质
data.labels.belong	string	隶属单位
data.labels.f985	string	是否 985 院校
data.labels.f211	string	是否 211 院校
data.labels.dual_class_name	string	双一流类别名称
data.labels.is_art	string	是否艺术类
data.labels.is_hot	string	是否热门
data.labels.key_level	string	重点级别
data.labels.rank_overall	string	综合排名
data.labels.ruanke_rank	string	软科排名
data.labels.wsl_rank	string	武书连排名
data.labels.qs_rank	string	QS 排名
data.labels.xyh_rank	string	校友会排名
data.labels.num_subject	string	重点学科数
data.labels.num_master	string	硕士点数量
data.labels.num_doctor	string	博士点数量
data.labels.num_academician	string	院士数量
data.labels.baoyan_rate	string	保研率
data.labels.province	string	省份
data.labels.city	string	城市
data.labels.area	string	区县
data.labels.address	string	详细地址
data.labels.postcode	string	邮编
data.labels.lat	string	纬度
data.labels.lng	string	经度
data.labels.phone	string	电话
data.labels.email	string	邮箱地址
data.labels.site	string	网站
data.labels.school_site	string	学校官网
data.labels.create_date	string	创建日期
data.labels.area_size	string	占地面积
data.labels.content	string	内容
data.brief	array	精简字段名列表
data.brief[]	string	精简字段名

请求示例

返回示例

{"msg":"success","code":200,"data":{"brief":["id","school_code","name"],"fields":["id","school_code","school_id_code"],"labels":{"id":"ID","lat":"纬度","lng":"经度","area":"区县","city":"城市","f211":"211","f985":"985","name":"学校名称","site":"招生网","email":"邮箱","phone":"电话","short":"简称","belong":"隶属单位","is_art":"艺术类","is_hot":"热门","address":"地址","content":"简介","qs_rank":"QS排名","old_name":"曾用名","postcode":"邮编","province":"省份","wsl_rank":"武书连排名","xyh_rank":"校友会排名","area_size":"占地面积","key_level":"重点级别","type_name":"类型","num_doctor":"博士点","num_master":"硕士点","baoyan_rate":"保研率","create_date":"建校年份","num_subject":"重点学科数","ruanke_rank":"软科排名","school_code":"院校代码","school_site":"官网","rank_overall":"综合排名","school_id_code":"学校标识码","dual_class_name":"双一流","num_academician":"院士数","school_type_name":"办学层次","school_nature_name":"办学性质"}}}

高校类型列表

返回高校类型列表

返回高校的类型、办学性质、办学层次等可选值列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-types JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.types	array	类型列表
data.types[]	string	类型
data.natures	array	办学性质列表
data.natures[]	string	办学性质
data.levels	array	办学层次列表
data.levels[]	string	办学层次

请求示例

返回示例

{"msg":"success","code":200,"data":{"types":["体育类","其他","军事类"],"levels":["专科（高职）","中外合作办学","其他"],"natures":["中外合作办学","公办","民办"]}}

分数省份列表

返回分数线省份列表

返回投档分数线数据覆盖的省份列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/score-provinces JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	string	列表中的单条记录

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":["北京","吉林","四川"],"total":12}}

批次省份列表

返回批次线省份列表

返回一分一段（批次线）数据覆盖的省份列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/segment-provinces JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	string	列表中的单条记录

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":["上海","云南","内蒙古"],"total":30}}

学科字段列表

返回学科可查询字段

返回学科数据支持的学科、第四轮/第五轮评估等级、专业门类等可选值列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/discipline-fields JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.disciplines	array	学科列表
data.disciplines[]	string	学科
data.round4_grades	array	第四轮学科评估等级列表
data.round4_grades[]	string	第四轮学科评估等级
data.round5_grades	array	第五轮学科评估等级列表
data.round5_grades[]	string	第五轮学科评估等级
data.categories	array	分类数据
data.categories[]	string	分类数据

请求示例

返回示例

{"msg":"success","code":200,"data":{"categories":["农学","医学","历史学"],"disciplines":["0101哲学","0201理论经济学","0202应用经济学"],"round4_grades":["A","A-","A+"],"round5_grades":["A","A-","A+"]}}

职业列表

返回职业分类列表

返回霍兰德性格代码、性格特质、职业方向、推荐专业与行业方向的完整列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/career-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].holland_code	string	霍兰德代码
data.list[].trait	string	性格特质
data.list[].careers	string	职业方向
data.list[].recommended_majors	string	推荐专业
data.list[].industries	string	行业方向
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"trait":"喜欢动手操作，解决具体问题，喜欢与实物打交道（机器、工具、动植物）\n擅长设备操作、硬件调试、现场工程、实体制造。排斥纯理论文案、高强度社交销售","careers":"工程师、技术人员、建筑师、飞行员、园艺师、运动员、机械技师、汽修技师、电工、钳工、焊工、测绘员、地质勘探员、畜牧养殖员、消防技术员、轨道运维员、设备维修工、造船技工、光伏安装师","created_at":"2026-07-02 17:30:00","industries":"高端装备制造、汽车零部件、船舶海工、光伏新能源、物联网硬件、工业母机、轨道交通、环保设备、模具塑料、半导体硬件封装","holland_code":"R 现实型","recommended_majors":"理工科：机械设计制造及其自动化、车辆工程、船舶与海洋工程、电气工程及其自动化、物联网工程、材料科学与工程、自动化、模具设计、能源与动力工程、给排水科学与工程、航空航天工程、测控技术与仪器\n文科：工业工程、工程管理、物流管理、报关与国际货运、设备采购管理"},{"id":2,"trait":"乐于探索分析，喜欢观察与解决问题，喜欢追求真理与知识。\n擅长实验研究、算法开发、数据分析、前沿技术攻关，反感流水线重复工作、商务应酬","careers":"科学家、研究员、分析师、医生、研发、程序员、实验员、地质学家、气象分析师、药剂师、病理检验师、算法工程师、数据挖掘师、环境监测研究员、生物研究员、量子技术研究员、行业研究员、医学检验师","created_at":"2026-07-02 17:30:00","industries":"集成电路、生物医药、人工智能、新型显示、光电子信息、大数据算力、半导体材料、工业软件、基因技术","holland_code":"I 研究型","recommended_majors":"理工科：人工智能、微电子科学与工程、计算机科学与技术、生物医学工程、药学、光电信息科学与工程、数据科学与大数据技术、化学工程与工艺、量子信息科学、材料物理、临床医学\n文科：应用经济学、统计学、知识产权法学、情报学、科技政策研究"},{"id":3,"trait":"富有想象力，渴望自我表达，追求独特性。\n擅长视觉创作、内容策划、品牌设计、文创IP打造，反感标准化流程、刻板行政事务","careers":"设计师、作家、音乐家、作家、摄影师、插画师、影视编导、配音演员、造型师、软装设计师、舞台策划、手绘师、短视频创作者、文旅策划师、服装搭配师、室内设计师、书法美术从业者","created_at":"2026-07-02 17:30:00","industries":"数字文创、直播电商、时尚纺织、美妆文创、建筑设计、安防视觉、文旅IP、跨境品牌视觉运营","holland_code":"A 艺术型","recommended_majors":"理工科：工业设计、数字媒体技术、纺织工程、轻化工程、建筑学、风景园林\n文科：网络与新媒体、广告学、文化产业管理、视觉传达设计、服装设计、会展策划、文创汉语言"}],"total":19}}

城市列表

返回城市列表

返回城市产业数据列表，包含城市的核心产业、推荐专业与代表企业。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/city-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].city	string	城市
data.list[].core_industries	string	核心产业
data.list[].recommended_majors	string	推荐专业
data.list[].leading_companies	string	龙头企业
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"city":"北京","created_at":"2026-07-02 17:30:00","core_industries":"人工智能、集成电路、金融总部、政务经济、文化传媒、生物医药、航空航天、法律咨询","leading_companies":"百度、寒武纪、中芯国际、工商银行、中金公司、高盛中国、诺诚健华、百济神州、中国航天科技、字节跳动、央视、大成律所、国务院发展研究中心","recommended_majors":"理工科：计算机科学与技术、人工智能、微电子科学与工程、生物医学工程、药学、飞行器设计与工程、量子信息科学\n文科类：金融学、法学、汉语言文学、新闻传播学、行政管理、公共事业管理、国际政治、商务英语、人力资源管理、市场营销、文化产业管理、会计学、财政学"},{"id":2,"city":"上海","created_at":"2026-07-02 17:30:00","core_industries":"国际金融、跨境对外贸易、集成电路、新能源汽车、生物医药、远洋航运贸易、广告创意、高端商务服务","leading_companies":"中微公司、紫光展锐、上海证券交易所、汇丰中国、特斯拉上海超级工厂、蔚来汽车、药明康德、中远海运、奥美广告、普华永道、拼多多","recommended_majors":"理工科：微电子科学与工程、车辆工程、药学、交通运输、人工智能、材料科学与工程\n文科类：国际经济与贸易、金融学、会计学、商务英语、法学、工商管理、市场营销、会展经济与管理、物流管理、人力资源管理、广告学、翻译、文化产业管理"},{"id":3,"city":"深圳","created_at":"2026-07-02 17:30:00","core_industries":"新一代信息通信、智能制造、跨境电商、人工智能、动力电池材料、高端医疗器械、金融创投、品牌出海运营","leading_companies":"华为、中兴通讯、大疆创新、比亚迪、欣旺达、迈瑞医疗、华大基因、腾讯、立讯精密、深创投、赛文思跨境、安克创新、影石360、拓竹科技","recommended_majors":"理工科：电子信息工程、软件工程、人工智能、通信工程、材料科学与工程、生物医学工程、车辆工程、智能制造工程\n文科类：国际经济与贸易、电子商务、金融学、法学、商务英语、市场营销、广告学、网络与新媒体、会计学、人力资源管理、供应链管理"}],"total":30}}

高校查询

精确查询高校

按关键词精确匹配高校名称，返回匹配到的高校详细信息。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	搜索关键词，必填；缺失 → 400，超过 128 字符 → 400，无法识别或查无数据 → 404
limit	integer	否	返回条数，默认 10，最大 20；超出范围按边界值处理
brief	boolean	否	精简字段
fields	string	否	指定返回字段（空格或逗号分隔），最多 40 项；超出 40 项截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].school_code	string	院校代码
data.list[].school_id_code	string	学校标识码
data.list[].name	string	名称
data.list[].short	string	简称
data.list[].old_name	string	曾用名
data.list[].type_name	string	类型名称
data.list[].school_type_name	string	办学层次
data.list[].school_nature_name	string	办学性质
data.list[].belong	string	隶属单位
data.list[].f985	integer	是否 985 院校
data.list[].f211	integer	是否 211 院校
data.list[].dual_class_name	string	双一流类别名称
data.list[].is_art	integer	是否艺术类
data.list[].is_hot	integer	是否热门
data.list[].key_level	string	重点级别
data.list[].rank_overall	integer	综合排名
data.list[].ruanke_rank	string	软科排名
data.list[].wsl_rank	string	武书连排名
data.list[].qs_rank	string	QS 排名
data.list[].xyh_rank	string	校友会排名
data.list[].num_subject	string	重点学科数
data.list[].num_master	string	硕士点数量
data.list[].num_doctor	string	博士点数量
data.list[].num_academician	string	院士数量
data.list[].baoyan_rate	string	保研率
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].area	string	区县
data.list[].address	string	详细地址
data.list[].postcode	string	邮编
data.list[].lat	string	纬度
data.list[].lng	string	经度
data.list[].phone	string	电话
data.list[].email	string	邮箱地址
data.list[].site	string	网站
data.list[].school_site	string	学校官网
data.list[].create_date	string	创建日期
data.list[].area_size	string	占地面积
data.list[].content	string	内容
data.total	integer	总条数
data.mode	string	查询匹配模式

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":109,"lat":"40.0096450","lng":"116.3333740","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"清华大学","site":"http://www.join-tsinghua.edu.cn","email":"zsb@mail.tsinghua.edu.cn","phone":"010-62782051,010-62770334","short":"北京清华,清华","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区清华园1号","content":"清华大学的前身清华学堂始建于1911年，1912年更名为清华学校。1928年更名为国立清华大学。1937年抗日战争全面爆发后南迁长沙，与北京大学、南开大学组建国立长沙临时大学，1938年迁至昆明改名为国立西南联合大学。1946年迁回清华园，设有文、法、理、工、农等5个学院、26个系。1952年全国高等学校院系调整后，清华大学成为一所多科性工业大学，重点为国家培养工程技术人","qs_rank":"1","old_name":"","postcode":"100084","province":"北京","wsl_rank":"1","xyh_rank":"2","area_size":"5886.00","key_level":"公办","type_name":"综合类","num_doctor":"58","num_master":"66","baoyan_rate":"58.3%","create_date":"1911","num_subject":"39","ruanke_rank":"1","school_code":"10003","school_site":"https://www.tsinghua.edu.cn/publish/thu2018/index.html","rank_overall":2,"school_id_code":"4111010003","dual_class_name":"双一流","num_academician":"66","school_type_name":"普通本科","school_nature_name":"公办"}],"mode":"exact","total":1}}

高校搜索

搜索高校

按关键词模糊搜索高校，支持省份、城市、类型、层次、性质及 985/211 等条件过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-search JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	否	搜索关键词，可缺省；超过 128 字符 → 400，含非法字符 → 400；传了且查无数据 → 404
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	是否只返回精简字段
fields	string	否	指定返回字段（空格或逗号分隔），最多 40 项；超出 40 项截断，单字段超 64 字符忽略
province	string	否	省份
city	string	否	城市
type_name	string	否	高校类型（如综合类 / 理工类）
level	string	否	办学层次
nature	string	否	办学性质
f985	integer	否	是否 985 院校（1=是）
f211	integer	否	是否 211 院校（1=是）
is_hot	integer	否	是否热门院校（1=是）
dual_class	boolean	否	是否双一流院校（true=是）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].school_code	string	院校代码
data.list[].school_id_code	string	学校标识码
data.list[].name	string	名称
data.list[].short	string	简称
data.list[].old_name	string	曾用名
data.list[].type_name	string	类型名称
data.list[].school_type_name	string	办学层次
data.list[].school_nature_name	string	办学性质
data.list[].belong	string	隶属单位
data.list[].f985	integer	是否 985 院校
data.list[].f211	integer	是否 211 院校
data.list[].dual_class_name	string	双一流类别名称
data.list[].is_art	integer	是否艺术类
data.list[].is_hot	integer	是否热门
data.list[].key_level	string	重点级别
data.list[].rank_overall	integer	综合排名
data.list[].ruanke_rank	string	软科排名
data.list[].wsl_rank	string	武书连排名
data.list[].qs_rank	string	QS 排名
data.list[].xyh_rank	string	校友会排名
data.list[].num_subject	string	重点学科数
data.list[].num_master	string	硕士点数量
data.list[].num_doctor	string	博士点数量
data.list[].num_academician	string	院士数量
data.list[].baoyan_rate	string	保研率
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].area	string	区县
data.list[].address	string	详细地址
data.list[].postcode	string	邮编
data.list[].lat	string	纬度
data.list[].lng	string	经度
data.list[].phone	string	电话
data.list[].email	string	邮箱地址
data.list[].site	string	网站
data.list[].school_site	string	学校官网
data.list[].create_date	string	创建日期
data.list[].area_size	string	占地面积
data.list[].content	string	内容
data.total	integer	总条数
data.mode	string	查询匹配模式

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":109,"lat":"40.0096450","lng":"116.3333740","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"清华大学","site":"http://www.join-tsinghua.edu.cn","email":"zsb@mail.tsinghua.edu.cn","phone":"010-62782051,010-62770334","short":"北京清华,清华","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区清华园1号","content":"清华大学的前身清华学堂始建于1911年，1912年更名为清华学校。1928年更名为国立清华大学。1937年抗日战争全面爆发后南迁长沙，与北京大学、南开大学组建国立长沙临时大学，1938年迁至昆明改名为国立西南联合大学。1946年迁回清华园，设有文、法、理、工、农等5个学院、26个系。1952年全国高等学校院系调整后，清华大学成为一所多科性工业大学，重点为国家培养工程技术人","qs_rank":"1","old_name":"","postcode":"100084","province":"北京","wsl_rank":"1","xyh_rank":"2","area_size":"5886.00","key_level":"公办","type_name":"综合类","num_doctor":"58","num_master":"66","baoyan_rate":"58.3%","create_date":"1911","num_subject":"39","ruanke_rank":"1","school_code":"10003","school_site":"https://www.tsinghua.edu.cn/publish/thu2018/index.html","rank_overall":2,"school_id_code":"4111010003","dual_class_name":"双一流","num_academician":"66","school_type_name":"普通本科","school_nature_name":"公办"}],"mode":"like","total":1}}

高校列表

分页返回高校列表

分页返回高校列表，支持省份、城市、类型、层次、性质及 985/211 等条件过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	是否只返回精简字段
fields	string	否	指定返回字段（空格或逗号分隔），最多 40 项；超出 40 项截断，单字段超 64 字符忽略
province	string	否	省份
city	string	否	城市
type_name	string	否	高校类型（如综合类 / 理工类）
level	string	否	办学层次
nature	string	否	办学性质
f985	integer	否	是否 985 院校（1=是）
f211	integer	否	是否 211 院校（1=是）
is_hot	integer	否	是否热门院校（1=是）
dual_class	boolean	否	是否双一流院校（true=是）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].school_code	string	院校代码
data.list[].school_id_code	string	学校标识码
data.list[].name	string	名称
data.list[].short	string	简称
data.list[].old_name	string	曾用名
data.list[].type_name	string	类型名称
data.list[].school_type_name	string	办学层次
data.list[].school_nature_name	string	办学性质
data.list[].belong	string	隶属单位
data.list[].f985	integer	是否 985 院校
data.list[].f211	integer	是否 211 院校
data.list[].dual_class_name	string	双一流类别名称
data.list[].is_art	integer	是否艺术类
data.list[].is_hot	integer	是否热门
data.list[].key_level	string	重点级别
data.list[].rank_overall	integer	综合排名
data.list[].ruanke_rank	string	软科排名
data.list[].wsl_rank	string	武书连排名
data.list[].qs_rank	string	QS 排名
data.list[].xyh_rank	string	校友会排名
data.list[].num_subject	string	重点学科数
data.list[].num_master	string	硕士点数量
data.list[].num_doctor	string	博士点数量
data.list[].num_academician	string	院士数量
data.list[].baoyan_rate	string	保研率
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].area	string	区县
data.list[].address	string	详细地址
data.list[].postcode	string	邮编
data.list[].lat	string	纬度
data.list[].lng	string	经度
data.list[].phone	string	电话
data.list[].email	string	邮箱地址
data.list[].site	string	网站
data.list[].school_site	string	学校官网
data.list[].create_date	string	创建日期
data.list[].area_size	string	占地面积
data.list[].content	string	内容
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":2,"lat":"39.9988770","lng":"116.3168330","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"北京大学","site":"http://www.gotopku.cn","email":"bdzsb@pku.edu.cn","phone":"010-62751407,010-62554332","short":"pku,北大","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区颐和园路5号","content":"北京大学创办于1898年，初名京师大学堂，是中国第一所国立综合性大学，也是当时中国最高教育行政机关。辛亥革命后，于1912年改为现名。作为新文化运动的中心和“五四”运动的策源地，作为中国最早传播马克思主义和民主科学思想的发祥地，作为中国共产党最早的活动基地，北京大学为民族的振兴和解放、国家的建设和发展、社会的文明和进步做出了不可替代的贡献，在","qs_rank":"2","old_name":"","postcode":"100871","province":"北京","wsl_rank":"2","xyh_rank":"1","area_size":"7000.00","key_level":"公办","type_name":"综合类","num_doctor":"307","num_master":"333","baoyan_rate":"56%","create_date":"1898","num_subject":"49","ruanke_rank":"2","school_code":"10001","school_site":"https://www.pku.edu.cn//","rank_overall":1,"school_id_code":"4111010001","dual_class_name":"双一流","num_academician":"58","school_type_name":"普通本科","school_nature_name":"公办"},{"id":1070,"lat":null,"lng":null,"area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"北京大学医学部","site":"http://jiaoyuchu.bjmu.edu.cn/zsjy/zsgz/index.htm","email":"","phone":"010-82802223,82802191","short":"北大医学部","belong":"教育部","is_art":0,"is_hot":0,"address":"北京市海淀区学院路38号北京大学医学部","content":"北京大学医学教育开始于1912年，建校后先后称为国立北京医科专门学校、北京大学医学院、北京医学院、北京医科大学。2000年与北京大学合并成为新的北京大学后，改称北京大学医学部。北京大学医学部在长达近一个世纪的办学实践中，逐渐形成了“勤奋、严谨、求实、创新”的学风和“坚定正确的政治方向，严谨求实的治学态度，热忱献身的服务精神”的校风。北京大学医","qs_rank":"0","old_name":"","postcode":"100191","province":"北京","wsl_rank":"0","xyh_rank":"0","area_size":"0.00","key_level":"公办","type_name":"医药类","num_doctor":"88","num_master":"93","baoyan_rate":"","create_date":"1912","num_subject":"0","ruanke_rank":"0","school_code":"1045","school_site":"http://www.bjmu.edu.cn","rank_overall":1,"school_id_code":"","dual_class_name":"双一流","num_academician":"0","school_type_name":"普通本科","school_nature_name":"公办"},{"id":109,"lat":"40.0096450","lng":"116.3333740","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"清华大学","site":"http://www.join-tsinghua.edu.cn","email":"zsb@mail.tsinghua.edu.cn","phone":"010-62782051,010-62770334","short":"北京清华,清华","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区清华园1号","content":"清华大学的前身清华学堂始建于1911年，1912年更名为清华学校。1928年更名为国立清华大学。1937年抗日战争全面爆发后南迁长沙，与北京大学、南开大学组建国立长沙临时大学，1938年迁至昆明改名为国立西南联合大学。1946年迁回清华园，设有文、法、理、工、农等5个学院、26个系。1952年全国高等学校院系调整后，清华大学成为一所多科性工业大学，重点为国家培养工程技术人","qs_rank":"1","old_name":"","postcode":"100084","province":"北京","wsl_rank":"1","xyh_rank":"2","area_size":"5886.00","key_level":"公办","type_name":"综合类","num_doctor":"58","num_master":"66","baoyan_rate":"58.3%","create_date":"1911","num_subject":"39","ruanke_rank":"1","school_code":"10003","school_site":"https://www.tsinghua.edu.cn/publish/thu2018/index.html","rank_overall":2,"school_id_code":"4111010003","dual_class_name":"双一流","num_academician":"66","school_type_name":"普通本科","school_nature_name":"公办"}],"page":1,"total":2918,"page_size":20}}

高校详情

按 ID 获取高校详情

按高校 ID 获取单个高校的详细信息。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-detail JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
id	integer	是	高校 ID；缺失或 ≤ 0 → 400；不存在 → 404（未找到该院校）
brief	boolean	否	是否只返回精简字段，默认 true
fields	string	否	指定返回字段（空格或逗号分隔），最多 40 项；超出 40 项截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.id	integer	唯一标识
data.school_code	string	院校代码
data.name	string	名称
data.short	string	简称
data.type_name	string	类型名称
data.school_type_name	string	办学层次
data.school_nature_name	string	办学性质
data.f985	integer	是否 985 院校
data.f211	integer	是否 211 院校
data.dual_class_name	string	双一流类别名称
data.rank_overall	integer	综合排名
data.baoyan_rate	string	保研率
data.province	string	省份
data.city	string	城市

请求示例

返回示例

{"msg":"success","code":200,"data":{"id":1,"city":"北京市","f211":1,"f985":0,"name":"北京工业大学","short":"bjut,北工大","province":"北京","type_name":"理工类","baoyan_rate":"7.7%","school_code":"10005","rank_overall":82,"dual_class_name":"双一流","school_type_name":"普通本科","school_nature_name":"公办"}}

高校批量查询

批量查询高校

根据 ID / 名称 / 院校代码数组批量查询高校信息，单次最多 10 条，超出直接报错（4002）。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/school-batch JSON

请求参数

参数名	类型	必填	说明
items	array	是	院校名称数组，最多 10 个，超出直接报错（4002）
key	string	否	匹配字段 id/name/school_code。注意：参数名与认证密钥参数 key 同名，请使用 Authorization 请求头认证，勿用 URL 的 key 参数传递密钥
brief	boolean	否	是否只返回精简字段
fields	string	否	指定返回字段（空格或逗号分隔），最多 40 项；超出 40 项截断，单字段超 64 字符忽略
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].school_code	string	院校代码
data.list[].school_id_code	string	学校标识码
data.list[].name	string	名称
data.list[].short	string	简称
data.list[].old_name	string	曾用名
data.list[].type_name	string	类型名称
data.list[].school_type_name	string	办学层次
data.list[].school_nature_name	string	办学性质
data.list[].belong	string	隶属单位
data.list[].f985	integer	是否 985 院校
data.list[].f211	integer	是否 211 院校
data.list[].dual_class_name	string	双一流类别名称
data.list[].is_art	integer	是否艺术类
data.list[].is_hot	integer	是否热门
data.list[].key_level	string	重点级别
data.list[].rank_overall	integer	综合排名
data.list[].ruanke_rank	string	软科排名
data.list[].wsl_rank	string	武书连排名
data.list[].qs_rank	string	QS 排名
data.list[].xyh_rank	string	校友会排名
data.list[].num_subject	string	重点学科数
data.list[].num_master	string	硕士点数量
data.list[].num_doctor	string	博士点数量
data.list[].num_academician	string	院士数量
data.list[].baoyan_rate	string	保研率
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].area	string	区县
data.list[].address	string	详细地址
data.list[].postcode	string	邮编
data.list[].lat	string	纬度
data.list[].lng	string	经度
data.list[].phone	string	电话
data.list[].email	string	邮箱地址
data.list[].site	string	网站
data.list[].school_site	string	学校官网
data.list[].create_date	string	创建日期
data.list[].area_size	string	占地面积
data.list[].content	string	内容
data.total	integer	总条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":2,"lat":"39.9988770","lng":"116.3168330","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"北京大学","site":"http://www.gotopku.cn","email":"bdzsb@pku.edu.cn","phone":"010-62751407,010-62554332","short":"pku,北大","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区颐和园路5号","content":"北京大学创办于1898年，初名京师大学堂，是中国第一所国立综合性大学，也是当时中国最高教育行政机关。辛亥革命后，于1912年改为现名。作为新文化运动的中心和“五四”运动的策源地，作为中国最早传播马克思主义和民主科学思想的发祥地，作为中国共产党最早的活动基地，北京大学为民族的振兴和解放、国家的建设和发展、社会的文明和进步做出了不可替代的贡献，在","qs_rank":"2","old_name":"","postcode":"100871","province":"北京","wsl_rank":"2","xyh_rank":"1","area_size":"7000.00","key_level":"公办","type_name":"综合类","num_doctor":"307","num_master":"333","baoyan_rate":"56%","create_date":"1898","num_subject":"49","ruanke_rank":"2","school_code":"10001","school_site":"https://www.pku.edu.cn//","rank_overall":1,"school_id_code":"4111010001","dual_class_name":"双一流","num_academician":"58","school_type_name":"普通本科","school_nature_name":"公办"},{"id":109,"lat":"40.0096450","lng":"116.3333740","area":"海淀区","city":"北京市","f211":1,"f985":1,"name":"清华大学","site":"http://www.join-tsinghua.edu.cn","email":"zsb@mail.tsinghua.edu.cn","phone":"010-62782051,010-62770334","short":"北京清华,清华","belong":"教育部","is_art":0,"is_hot":1,"address":"北京市海淀区清华园1号","content":"清华大学的前身清华学堂始建于1911年，1912年更名为清华学校。1928年更名为国立清华大学。1937年抗日战争全面爆发后南迁长沙，与北京大学、南开大学组建国立长沙临时大学，1938年迁至昆明改名为国立西南联合大学。1946年迁回清华园，设有文、法、理、工、农等5个学院、26个系。1952年全国高等学校院系调整后，清华大学成为一所多科性工业大学，重点为国家培养工程技术人","qs_rank":"1","old_name":"","postcode":"100084","province":"北京","wsl_rank":"1","xyh_rank":"2","area_size":"5886.00","key_level":"公办","type_name":"综合类","num_doctor":"58","num_master":"66","baoyan_rate":"58.3%","create_date":"1911","num_subject":"39","ruanke_rank":"1","school_code":"10003","school_site":"https://www.tsinghua.edu.cn/publish/thu2018/index.html","rank_overall":2,"school_id_code":"4111010003","dual_class_name":"双一流","num_academician":"66","school_type_name":"普通本科","school_nature_name":"公办"}],"total":2}}

分数线查询

查询分数线（纯筛选 + 分页，无匹配返回空列表）

按省份、批次、科类、院校、年份、分数区间、位次等条件分页查询投档分数线。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/score-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	否	省份
batch	string	否	录取批次
subject	string	否	科类
school_name	string	否	院校名称
school_code	string	否	院校代码
year	integer	否	年份
score_min	integer	否	最低分
score_max	integer	否	最高分
rank_max	integer	否	最大位次
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].year	integer	年份
data.list[].province	string	省份
data.list[].batch	string	录取批次
data.list[].subject	string	科目
data.list[].school_code	string	院校代码
data.list[].school_name	string	院校名称
data.list[].major_group_code	string	专业组代码
data.list[].major_group_name	string	专业组名称
data.list[].subject_req	string	选科要求
data.list[].major_code	string	专业代码
data.list[].major_name	string	专业名称
data.list[].score	integer	录取分数
data.list[].rank	integer	排名
data.list[].plan_num	string	计划招生人数
data.list[].admitted_num	string	录取人数
data.list[].remark	string	备注
data.list[].created_at	string	创建时间
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1478,"rank":null,"year":2025,"batch":"本科提前批A段","score":704,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1019","school_name":"中国科学院大学","subject_req":"物理+化学","admitted_num":null,"major_group_code":"2","major_group_name":""},{"id":39,"rank":136,"year":2025,"batch":"本科批","score":697,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1021","school_name":"北京大学","subject_req":"不限","admitted_num":null,"major_group_code":"2","major_group_name":""},{"id":44,"rank":303,"year":2025,"batch":"本科批","score":689,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1023","school_name":"清华大学","subject_req":"不限","admitted_num":null,"major_group_code":"1","major_group_name":""}],"page":1,"total":1552,"page_size":20}}

分数线列表

分页返回分数线

按省份分页返回投档分数线数据，可按科类、批次进一步过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/score-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	是	省份
subject	string	否	科类
batch	string	否	录取批次
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].year	integer	年份
data.list[].province	string	省份
data.list[].batch	string	录取批次
data.list[].subject	string	科目
data.list[].school_code	string	院校代码
data.list[].school_name	string	院校名称
data.list[].major_group_code	string	专业组代码
data.list[].major_group_name	string	专业组名称
data.list[].subject_req	string	选科要求
data.list[].major_code	string	专业代码
data.list[].major_name	string	专业名称
data.list[].score	integer	录取分数
data.list[].rank	integer	排名
data.list[].plan_num	string	计划招生人数
data.list[].admitted_num	string	录取人数
data.list[].remark	string	备注
data.list[].created_at	string	创建时间
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1478,"rank":null,"year":2025,"batch":"本科提前批A段","score":704,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1019","school_name":"中国科学院大学","subject_req":"物理+化学","admitted_num":null,"major_group_code":"2","major_group_name":""},{"id":39,"rank":136,"year":2025,"batch":"本科批","score":697,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1021","school_name":"北京大学","subject_req":"不限","admitted_num":null,"major_group_code":"2","major_group_name":""},{"id":44,"rank":303,"year":2025,"batch":"本科批","score":689,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1023","school_name":"清华大学","subject_req":"不限","admitted_num":null,"major_group_code":"1","major_group_name":""}],"page":1,"total":1552,"page_size":20}}

批次线查询

查询批次线

按省份分页查询一分一段（批次线）数据，支持科类、层次、年份、分数区间等过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/segment-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	是	省份
subject	string	否	科类
level	string	否	层次（本科 / 专科等）
year	integer	否	年份
score_min	integer	否	最低分
score_max	integer	否	最高分
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].province	string	省份
data.list[].year	integer	年份
data.list[].subject	string	科目
data.list[].level	string	等级
data.list[].rank_max	integer	最高排名
data.list[].rank_min	integer	最低排名
data.list[].rank_range	string	排名区间
data.list[].score_max	integer	最高分
data.list[].score_min	integer	最低分
data.list[].score_range	string	分数区间
data.list[].same_count	integer	同分人数
data.list[].created_at	string	创建时间
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":24025,"year":2025,"level":"本科","subject":"综合","province":"北京","rank_max":1,"rank_min":113,"score_max":750,"score_min":698,"created_at":"2026-07-02 17:30:00","rank_range":"1~113","same_count":113,"score_range":"698~750"},{"id":24026,"year":2025,"level":"本科","subject":"综合","province":"北京","rank_max":114,"rank_min":136,"score_max":697,"score_min":697,"created_at":"2026-07-02 17:30:00","rank_range":"114~136","same_count":23,"score_range":"697"},{"id":24027,"year":2025,"level":"本科","subject":"综合","province":"北京","rank_max":137,"rank_min":148,"score_max":696,"score_min":696,"created_at":"2026-07-02 17:30:00","rank_range":"137~148","same_count":12,"score_range":"696"}],"page":1,"total":347,"page_size":20}}

批次线列表

分页返回批次线

根据省份与高考分数查询对应的一分一段（批次线）数据。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/segment-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	是	省份
score	integer	是	高考分数
subject	string	否	科类
level	string	否	层次（本科 / 专科等）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].province	string	省份
data.list[].year	integer	年份
data.list[].subject	string	科目
data.list[].level	string	等级
data.list[].rank_max	integer	最高排名
data.list[].rank_min	integer	最低排名
data.list[].rank_range	string	排名区间
data.list[].score_max	integer	最高分
data.list[].score_min	integer	最低分
data.list[].score_range	string	分数区间
data.list[].same_count	integer	同分人数
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":24025,"year":2025,"level":"本科","subject":"综合","province":"北京","rank_max":1,"rank_min":113,"score_max":750,"score_min":698,"created_at":"2026-07-02 17:30:00","rank_range":"1~113","same_count":113,"score_range":"698~750"}],"total":1}}

录取数据查询

查询录取数据

按院校名称查询录取数据，可按省份过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/admit-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
school_name	string	是	院校名称，必填；缺失 → 400（缺少必要参数）；查无数据 → 404
province	string	否	省份
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].year	integer	年份
data.list[].province	string	省份
data.list[].batch	string	录取批次
data.list[].subject	string	科目
data.list[].school_code	string	院校代码
data.list[].school_name	string	院校名称
data.list[].major_group_code	string	专业组代码
data.list[].major_group_name	string	专业组名称
data.list[].subject_req	string	选科要求
data.list[].major_code	string	专业代码
data.list[].major_name	string	专业名称
data.list[].score	integer	录取分数
data.list[].rank	string	排名
data.list[].plan_num	integer	计划招生人数
data.list[].admitted_num	integer	录取人数
data.list[].remark	string	备注
data.list[].created_at	string	创建时间
data.total	integer	总条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":115356,"rank":null,"year":2025,"batch":"本科批","score":698,"remark":"","subject":"理工","plan_num":32,"province":"新疆","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1003","school_name":"清华大学","subject_req":"","admitted_num":32,"major_group_code":"","major_group_name":""},{"id":67086,"rank":null,"year":2025,"batch":"本科批","score":693,"remark":"","subject":"物理","plan_num":null,"province":"重庆","created_at":"2026-07-02 17:30:00","major_code":"51B","major_name":"理科试验班(理科各专业)","school_code":"1104","school_name":"清华大学","subject_req":"","admitted_num":null,"major_group_code":"","major_group_name":""},{"id":67085,"rank":null,"year":2025,"batch":"本科批","score":692,"remark":"","subject":"物理","plan_num":null,"province":"重庆","created_at":"2026-07-02 17:30:00","major_code":"51A","major_name":"临床医学类","school_code":"1104","school_name":"清华大学","subject_req":"","admitted_num":null,"major_group_code":"","major_group_name":""}],"total":50}}

录取数据列表

分页返回录取数据

分页返回录取数据，支持省份、批次、科类、院校、年份、分数区间、位次等过滤。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/admit-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	否	省份
batch	string	否	录取批次
subject	string	否	科类
school_name	string	否	院校名称
school_code	string	否	院校代码
year	integer	否	年份
score_min	integer	否	最低分
score_max	integer	否	最高分
rank_max	integer	否	最大位次
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].year	integer	年份
data.list[].province	string	省份
data.list[].batch	string	录取批次
data.list[].subject	string	科目
data.list[].school_code	string	院校代码
data.list[].school_name	string	院校名称
data.list[].major_group_code	string	专业组代码
data.list[].major_group_name	string	专业组名称
data.list[].subject_req	string	选科要求
data.list[].major_code	string	专业代码
data.list[].major_name	string	专业名称
data.list[].score	integer	录取分数
data.list[].rank	integer	排名
data.list[].plan_num	string	计划招生人数
data.list[].admitted_num	string	录取人数
data.list[].remark	string	备注
data.list[].created_at	string	创建时间
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1478,"rank":null,"year":2025,"batch":"本科提前批A段","score":704,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1019","school_name":"中国科学院大学","subject_req":"物理+化学","admitted_num":null,"major_group_code":"2","major_group_name":""},{"id":115356,"rank":null,"year":2025,"batch":"本科批","score":698,"remark":"","subject":"理工","plan_num":32,"province":"新疆","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1003","school_name":"清华大学","subject_req":"","admitted_num":32,"major_group_code":"","major_group_name":""},{"id":39,"rank":136,"year":2025,"batch":"本科批","score":697,"remark":"","subject":"综合","plan_num":null,"province":"北京","created_at":"2026-07-02 17:30:00","major_code":"","major_name":"","school_code":"1021","school_name":"北京大学","subject_req":"不限","admitted_num":null,"major_group_code":"2","major_group_name":""}],"page":1,"total":115858,"page_size":20}}

位次查询

查询位次对应分数

根据省份与位次查询对应的一分一段（位次 / 分数）数据。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/rank-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	是	省份
rank	integer	是	位次
subject	string	否	科类
level	string	否	层次（本科 / 专科等）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].province	string	省份
data.list[].year	integer	年份
data.list[].subject	string	科目
data.list[].level	string	层次
data.list[].rank_max	integer	最高位次
data.list[].rank_min	integer	最低位次
data.list[].rank_range	string	位次区间
data.list[].score_max	integer	最高分
data.list[].score_min	integer	最低分
data.list[].score_range	string	分数区间
data.list[].same_count	integer	同分人数
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4,"year":2025,"level":"本专","subject":"历史","province":"云南","rank_max":57,"rank_min":57,"score_max":652,"score_min":652,"created_at":"2026-07-02 17:30:00","rank_range":"57~57","same_count":1,"score_range":"652"}],"total":1}}

位次表

分页返回位次表

根据省份与位次查询对应的一分一段（位次 / 分数）数据，返回命中区间的分数与位次信息。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/rank-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
province	string	是	省份
rank	integer	是	位次
subject	string	否	科类
level	string	否	层次（本科 / 专科等）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].province	string	省份
data.list[].year	integer	年份
data.list[].subject	string	科目
data.list[].level	string	层次
data.list[].rank_max	integer	最高位次
data.list[].rank_min	integer	最低位次
data.list[].rank_range	string	位次区间
data.list[].score_max	integer	最高分
data.list[].score_min	integer	最低分
data.list[].score_range	string	分数区间
data.list[].same_count	integer	同分人数
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4,"year":2025,"level":"本专","subject":"历史","province":"云南","rank_max":57,"rank_min":57,"score_max":652,"score_min":652,"created_at":"2026-07-02 17:30:00","rank_range":"57~57","same_count":1,"score_range":"652"}],"total":1}}

学科查询

查询学科（纯筛选 + 分页，无匹配返回空列表）

按学科、院校、评估等级、专业门类、省份等条件分页查询学科评估数据。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/discipline-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
discipline	string	否	学科关键词
university_name	string	否	高校名称
round4_grade	string	否	第四轮评估等级
round5_grade	string	否	第五轮评估等级
major_category	string	否	专业门类
province	string	否	省份
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].discipline	string	学科
data.list[].round4_grade	string	第四轮学科评估等级
data.list[].round4_school	string	第四轮评估院校
data.list[].round5_grade	string	第五轮学科评估等级
data.list[].round5_school	string	第五轮评估院校
data.list[].round5_desc	string	第五轮评估说明
data.list[].major_category	string	专业门类
data.list[].major_class	string	专业类
data.list[].university_name	string	高校名称
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].university_tag	string	高校标签
data.list[].dual_class	string	双一流类别
data.list[].university_nature	string	高校办学性质
data.list[].created_at	string	创建时间
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":2719,"city":"北京市","province":"北京","created_at":"2026-07-02 17:30:00","discipline":"0812计算机科学与技术","dual_class":"一流大学","major_class":"计算机类","round5_desc":"取得最佳成绩","round4_grade":"A+","round5_grade":"A+","round4_school":"10001北京大学","round5_school":"北京大学","major_category":"工学","university_tag":"C9,985,211","university_name":"北京大学","university_nature":"公办"},{"id":2720,"city":"北京市","province":"北京","created_at":"2026-07-02 17:30:00","discipline":"0812计算机科学与技术","dual_class":"一流大学","major_class":"计算机类","round5_desc":"","round4_grade":"A+","round5_grade":"A+","round4_school":"10003清华大学","round5_school":"清华大学","major_category":"工学","university_tag":"C9,985,211","university_name":"清华大学","university_nature":"公办"},{"id":2721,"city":"杭州市","province":"浙江","created_at":"2026-07-02 17:30:00","discipline":"0812计算机科学与技术","dual_class":"一流大学","major_class":"计算机类","round5_desc":"持续保持优势","round4_grade":"A+","round5_grade":"A+","round4_school":"10335浙江大学","round5_school":"浙江大学","major_category":"工学","university_tag":"C9,985,211","university_name":"浙江大学","university_nature":"公办"}],"page":1,"total":168,"page_size":20}}

学科列表

分页返回学科列表

根据院校名称查询该校的学科评估数据，最多返回 20 条。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/discipline-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
university_name	string	是	院校名称
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].discipline	string	学科
data.list[].round4_grade	string	第四轮学科评估等级
data.list[].round4_school	string	第四轮评估院校
data.list[].round5_grade	string	第五轮学科评估等级
data.list[].round5_school	string	第五轮评估院校
data.list[].round5_desc	string	第五轮评估说明
data.list[].major_category	string	专业门类
data.list[].major_class	string	专业类
data.list[].university_name	string	高校名称
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].university_tag	string	高校标签
data.list[].dual_class	string	双一流类别
data.list[].university_nature	string	高校办学性质
data.list[].created_at	string	创建时间
data.total	integer	总条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":5127,"city":"北京市","province":"北京","created_at":"2026-07-02 17:30:00","discipline":"网络空间安全(新增)","dual_class":"一流大学","major_class":"计算机类","round5_desc":"","round4_grade":"","round5_grade":"A+","round4_school":"","round5_school":"清华大学","major_category":"工学","university_tag":"C9,985,211","university_name":"清华大学","university_nature":"公办"},{"id":234,"city":"北京市","province":"北京","created_at":"2026-07-02 17:30:00","discipline":"0301法学","dual_class":"一流大学","major_class":"法学类","round5_desc":"","round4_grade":"A","round5_grade":"","round4_school":"10003清华大学","round5_school":"","major_category":"法学","university_tag":"C9,985,211","university_name":"清华大学","university_nature":"公办"},{"id":1171,"city":"北京市","province":"北京","created_at":"2026-07-02 17:30:00","discipline":"0701数学","dual_class":"一流大学","major_class":"数学类","round5_desc":"","round4_grade":"A","round5_grade":"","round4_school":"10003清华大学","round5_school":"","major_category":"理学","university_tag":"C9,985,211","university_name":"清华大学","university_nature":"公办"}],"total":50}}

志愿推荐

按霍兰德代码推荐职业与专业

根据霍兰德代码查询匹配的性格特质、职业方向、推荐专业与行业方向。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/volunteer-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
code	string	是	霍兰德代码 R/I/A/S/E/C（可多字母组合，不区分大小写）；含其它字符 → 400

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].holland_code	string	霍兰德代码
data.list[].trait	string	性格特质
data.list[].careers	string	职业方向
data.list[].recommended_majors	string	推荐专业
data.list[].industries	string	行业方向
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"trait":"喜欢动手操作，解决具体问题，喜欢与实物打交道（机器、工具、动植物）\n擅长设备操作、硬件调试、现场工程、实体制造。排斥纯理论文案、高强度社交销售","careers":"工程师、技术人员、建筑师、飞行员、园艺师、运动员、机械技师、汽修技师、电工、钳工、焊工、测绘员、地质勘探员、畜牧养殖员、消防技术员、轨道运维员、设备维修工、造船技工、光伏安装师","created_at":"2026-07-02 17:30:00","industries":"高端装备制造、汽车零部件、船舶海工、光伏新能源、物联网硬件、工业母机、轨道交通、环保设备、模具塑料、半导体硬件封装","holland_code":"R 现实型","recommended_majors":"理工科：机械设计制造及其自动化、车辆工程、船舶与海洋工程、电气工程及其自动化、物联网工程、材料科学与工程、自动化、模具设计、能源与动力工程、给排水科学与工程、航空航天工程、测控技术与仪器\n文科：工业工程、工程管理、物流管理、报关与国际货运、设备采购管理"},{"id":7,"trait":"偏向硬件工艺研发、设备算法优化，动手能力强同时具备科研钻研能力","careers":"硬件研发工程师、设备调试研究员、医疗器械研发师、传感器工程师、专利技术代理人、半导体工艺技术员、工业设备研发专员、精密仪器检测研究员","created_at":"2026-07-02 17:30:00","industries":"精密设备研发、传感器迭代、半导体封装工艺、医疗器械硬件、工业母机研发","holland_code":"RI 现实+研究","recommended_majors":"理工科：机械电子工程、测控技术、材料成型、物联网硬件研发、生物医学器械工程\n文科：技术经济学、专利代理、工业标准化管理"},{"id":8,"trait":"擅长工业外观设计、装备美学改造、实体产品造型，兼具动手制造与审美能力","careers":"工业造型设计师、产品结构设计师、汽车外观设计师、景观施工设计师、家居软装工艺师、户外装备设计员、纺织设备美学设计师、展厅工装设计师","created_at":"2026-07-02 17:30:00","industries":"汽车外观设计、模具美学、智能装备造型、高端家纺设计、户外设备外观研发","holland_code":"RA 现实+艺术","recommended_majors":"理工科：工业设计、产品结构设计、纺织装备设计、景观工程\n文科：产品造型策划、家居美学设计、工装展示设计"}],"total":5}}

志愿推荐列表

分页返回志愿推荐

根据高考分数、省份、科类推荐“冲 / 稳 / 保”三档志愿院校列表。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/volunteer-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
score	integer	是	高考分数
province	string	是	省份
subject	string	是	科类
limit	integer	否	返回条数，默认 10，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.year	integer	数据年份
data.score	integer	高考分数
data.province	string	省份
data.subject	string	科类
data.counts	object	各档院校数量统计
data.counts.rush	integer	冲档院校数量
data.counts.stable	integer	稳档院校数量
data.counts.safe	integer	保档院校数量
data.rush	array	冲档院校列表
data.rush[]	object	列表中的单条记录
data.rush[].school_name	string	院校名称
data.rush[].line	integer	院校投档线
data.rush[].max_score	integer	院校最高分
data.rush[].major_count	integer	专业数量
data.rush[].diff	integer	与用户分数的差值
data.rush[].level	string	档位标识（rush/stable/safe）
data.stable	array	稳档院校列表
data.stable[]	object	列表中的单条记录
data.stable[].school_name	string	院校名称
data.stable[].line	integer	院校投档线
data.stable[].max_score	integer	院校最高分
data.stable[].major_count	integer	专业数量
data.stable[].diff	integer	与用户分数的差值
data.stable[].level	string	档位标识（rush/stable/safe）
data.safe	array	保档院校列表
data.safe[]	object	列表中的单条记录
data.safe[].school_name	string	院校名称
data.safe[].line	integer	院校投档线
data.safe[].max_score	integer	院校最高分
data.safe[].major_count	integer	专业数量
data.safe[].diff	integer	与用户分数的差值
data.safe[].level	string	档位标识（rush/stable/safe）

请求示例

返回示例

{"msg":"success","code":200,"data":{"rush":[{"diff":-15,"line":615,"level":"rush","max_score":637,"major_count":5,"school_name":"北京外国语大学[公办]"},{"diff":-13,"line":613,"level":"rush","max_score":615,"major_count":2,"school_name":"上海外国语大学[公办]"},{"diff":-13,"line":613,"level":"rush","max_score":652,"major_count":35,"school_name":"南京航空航天大学[公办]"}],"safe":[{"diff":15,"line":585,"level":"safe","max_score":654,"major_count":12,"school_name":"南方医科大学[公办]"},{"diff":15,"line":585,"level":"safe","max_score":623,"major_count":44,"school_name":"南昌大学[公办]"},{"diff":15,"line":585,"level":"safe","max_score":585,"major_count":1,"school_name":"河北工业大学(少数民族预科班)[公办]"}],"year":2025,"score":600,"counts":{"rush":24,"safe":1096,"stable":40},"stable":[{"diff":0,"line":600,"level":"stable","max_score":610,"major_count":4,"school_name":"上海理工大学[公办]"},{"diff":0,"line":600,"level":"stable","max_score":643,"major_count":14,"school_name":"中国药科大学(南京市)[公办]"},{"diff":0,"line":600,"level":"stable","max_score":637,"major_count":2,"school_name":"南京医科大学[公办]"}],"subject":"物理","province":"河北"}}

宿舍查询

查询高校宿舍

按关键词或省份、城市、层次、性质等条件分页查询高校宿舍信息。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/dorm-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	否	搜索关键词，可缺省；超过 128 字符 → 400，含非法字符 → 400；传了且查无数据 → 404
province	string	否	省份
city	string	否	城市
level	string	否	办学层次
nature	string	否	办学性质
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].university_name	string	高校名称
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].city_tier	string	城市等级
data.list[].level	string	办学层次
data.list[].nature	string	办学性质
data.list[].address	string	地址
data.list[].multi_campus	string	是否多校区
data.list[].bed_desk	string	是否上床下桌
data.list[].room_type	string	宿舍人数 / 类型
data.list[].dorm_ac	string	宿舍是否有空调
data.list[].classroom_ac	string	教室是否有空调
data.list[].private_bath	string	是否有独立卫浴
data.list[].bath_time	string	洗浴时间说明
data.list[].washer	string	洗衣机配置
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":480,"city":"延庆","level":"专科","nature":"公办","washer":"","address":"","dorm_ac":"","bed_desk":"","province":"北京","bath_time":"","city_tier":"","room_type":"","created_at":"2026-07-02 17:30:00","classroom_ac":"","multi_campus":"","private_bath":"","university_name":"北京科技大学延庆分校"},{"id":1713,"city":"密云","level":"专科","nature":"公办","washer":"","address":"北京市密云区西大桥路7号","dorm_ac":"","bed_desk":"","province":"北京","bath_time":"","city_tier":"","room_type":"","created_at":"2026-07-02 17:30:00","classroom_ac":"","multi_campus":"","private_bath":"","university_name":"首都经济贸易大学密云分校"}],"page":1,"total":98,"page_size":2}}

宿舍列表

查询指定院校宿舍

根据院校名称查询该校的宿舍信息，最多返回 20 条。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/dorm-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
university_name	string	是	院校名称，必填；缺失 → 400（缺少必要参数）；查无数据 → 404
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].university_name	string	高校名称
data.list[].province	string	省份
data.list[].city	string	城市
data.list[].city_tier	string	城市等级
data.list[].level	string	办学层次
data.list[].nature	string	办学性质
data.list[].address	string	地址
data.list[].multi_campus	string	是否多校区
data.list[].bed_desk	string	是否上床下桌
data.list[].room_type	string	宿舍人数 / 类型
data.list[].dorm_ac	string	宿舍是否有空调
data.list[].classroom_ac	string	教室是否有空调
data.list[].private_bath	string	是否有独立卫浴
data.list[].bath_time	string	洗浴时间说明
data.list[].washer	string	洗衣机配置
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":2881,"city":"北京","level":"本科","nature":"公办","washer":"有，每层有","address":"北京市海淀区清华园1号","dorm_ac":"有","bed_desk":"是","province":"北京","bath_time":"分时段（6:00-24:00，每周一天检修）","city_tier":"一线","room_type":"4","created_at":"2026-07-02 17:30:00","classroom_ac":"有","multi_campus":"","private_bath":"无","university_name":"清华大学"}],"total":1}}

城市搜索

搜索城市产业数据

按关键词搜索城市产业数据，返回城市的核心产业、推荐专业与代表企业。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/gaokao/city-search JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	城市关键词；缺失 → 400，超过 128 字符 → 400，查无数据 → 404

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].city	string	城市
data.list[].core_industries	string	核心产业
data.list[].recommended_majors	string	推荐专业
data.list[].leading_companies	string	代表企业
data.list[].created_at	string	创建时间

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"city":"北京","created_at":"2026-07-02 17:30:00","core_industries":"人工智能、集成电路、金融总部、政务经济、文化传媒、生物医药、航空航天、法律咨询","leading_companies":"百度、寒武纪、中芯国际、工商银行、中金公司、高盛中国、诺诚健华、百济神州、中国航天科技、字节跳动、央视、大成律所、国务院发展研究中心","recommended_majors":"理工科：计算机科学与技术、人工智能、微电子科学与工程、生物医学工程、药学、飞行器设计与工程、量子信息科学\n文科类：金融学、法学、汉语言文学、新闻传播学、行政管理、公共事业管理、国际政治、商务英语、人力资源管理、市场营销、文化产业管理、会计学、财政学"}],"total":1}}

产品说明

产品概述

全国高考数据查询，涵盖分数线/高校/专业/录取/位次/志愿推荐。

使用场景

数据查询：快速集成全国高考数据查询到您的应用中

业务系统：将全国高考数据查询数据嵌入业务流程

开发工具：通过 API 接口获取教育学习数据

数据分析：基于全国高考数据查询数据进行分析和决策

费用计算

按次计费单价

¥0.004 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.4	¥0.0040/次	-	365 天
500次调用包	500 次	¥1.9	¥0.0038/次	省5%	365 天
1000次调用包	1000 次	¥3.6	¥0.0036/次	省10%	365 天
5000次调用包	5000 次	¥17	¥0.0034/次	省15%	365 天
10000次调用包	10000 次	¥32	¥0.0032/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.004/次
个人版	5000 次	5000 次	10%	¥0.0036/次
专业版	30000 次	30000 次	20%	¥0.0032/次
企业版推荐	200000 次	200000 次	30%	¥0.0028/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.004 × 1000 = ¥4.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.004 × (1 - 10%) × 1000 ≈ ¥3.60

示例3：购买「500次调用包」次数包

支付 ¥1.90，获得 500 次调用，折算单价 ¥0.0038/次

同等次数按次付费需 ¥2.00，次数包可节省 ¥0.10

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志