1. 产品功能

全国高校各专业在全国各省的详细录取数据，从 2015 年至 2020 年；
三百万已校对历史数据；
多种查询条件便于多维度分析；
返回数据包含该专业录取的最低分、最高分、平均分、最低位次等信息；
数据持续更新与维护；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
全面兼容 Apple ATS；
全国多节点 CDN 部署；
接口极速响应，多台服务器构建 API 接口负载均衡。

2. API 文档

API 详情地址: https://www.gugudata.com/api/details/ceemajorline

接口请求地址: https://api.gugudata.com/metadata/ceemajorline

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

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/metadata/ceemajorline?appkey=YOUR_APPKEY&pageindex=1&pagesize=10&enrollprovince=&schoolname=&majorname=&year=0&min=0&batchname=&typename=

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

接口测试: https://api.gugudata.com/metadata/ceemajorline/demo

3. 请求参数（如果为 POST 请求，那么参数以 JSON 的格式传递）

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
pageindex	int	是	1	分页参数，第几页
pagesize	int	是	10	分页参数，每页总条数，取值范围在 10 ~ 50 之间
enrollprovince	string	否		招生省份的条件，如查询北京大学计算机科学与技术专业在江苏的录取数据，那么该值传递 “江苏” 即可。(enrollprovince、schoolname、majorname 三个参数都不是必选参数，但不可同时为空)
schoolname	string	否		高校名称。(enrollprovince、schoolname、majorname 三个参数都不是必选参数，但不可同时为空)
majorname	string	否		专业名称，如电气工程与智能控制、计算机科学与技术等，此参数支持模糊搜索。(enrollprovince、schoolname、majorname 三个参数都不是必选参数，但不可同时为空)
year	int	否	0	查询的录取年份，如 2019、2020。参数默认值为 0：即获取所有年份的录取数据
min	int	否	0	录取最低分查询条件，筛选出最低分小于等于查询条件的值。默认值为 0，不进行筛选
batchname	string	否		专业所属的录取批次，传递参数可选值为：本科二批\|专科批\|本科一批\|本科批\|本科三批\|本科二批A段\|本科一批A段\|平行录取二段\|平行录取一段\|本科提前批\|平行录取三段\|普通类一段\|本科批A段\|本科二批C段\|本科一批B段\|本科二批B段\|本科三批A段\|本科二批及预科\|普通类二段\|专科批A段\|本科批B段\|国家专项计划本科批\|本科提前批A段\|专科提前批\|地方专项计划本科批\|本科提前批B段\|分类招生批\|提前批\|本科一批A1段\|本科一段\|高校专项计划本科批\|本科A批\|普通类提前批\|本科二段\|零志愿批次\|零批次\|无批次\|国家专项计划本科一批\|本科二批K段
typename	string	否		专业所属的类型，传递参数可选值为：理科\|文科\|综合\|艺术类\|艺术文\|体育类\|艺术理\|学考理\|体育理\|学考文\|蒙授文科\|蒙授理科\|3+证书\|体育文\|计算机类\|会计类\|土建类\|旅游类\|护理类\|电子技术类\|农学类\|汽车类\|幼师类\|美工设计类\|机械加工类\|电子商务类\|财会类\|汉授美术\|电气技术类\|畜牧兽医类\|药剂类\|农林类\|牧医类\|汽驾类\|服装设计与工艺类\|蒙牧医类\|其他艺术\|汉授音乐\|建筑类\|烹饪类\|医学类\|教育类\|园林类

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
DataStatus.RequestParameter	string	请求参数，一般用于调试
Data.ProvinceName	string	招生的省份
Data.SchoolName	string	高校名称
Data.MajorName	string	专业名称
Data.Year	int	招生年份
Data.HighSocre	int\|string	录取最高分，没有值时返回 ‘-’
Data.AverageScore	int\|string	录取平均分，没有值时返回 ‘-’
Data.LowestScore	int	录取最低分
Data.LowestSection	int\|string	录取最低位次，没有值时返回 ‘-’
Data.BatchName	string	录取批次，如本科二批、专科批、本科一批等
Data.TypeName	string	专业所属的类型，如理科、文科、综合、艺术类等
Data.ProScore	int\|string	专业分，部分高校专业录取有此值，没有值时返回 ‘-’

5. 接口响应状态码

状态码	状态码解释	备注
100	正常返回
501	参数错误	请检查您传递的参数个数以及参数类型是否匹配
502	请求频率受限	一般建议每秒请求不超过 100 次
503	APPKEY 权限超限/订单到期	请至开发者中心检查您的 APPKEY 是否到期或是否权限超限
504	APPKEY 错误	请检查传递的 APPKEY 是否为开发者中心获取到的值
505	请求的次数超出接口限制	请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数
900	接口响应错误	接口可用性为 99.999%，如获取到此状态码请邮件联系我们

6. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们五年来为企业客户提供的海量数据支撑，将部分通用数据、通用功能抽象成产品级 API，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了复杂功能的实现门槛与人力成本。

除了我们已开放的分类数据与接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口供用户使用。