历年高考专业录取分数线 API 接口
Published: 2023-08-28 01:13:55

历年高考专业录取分数线 API 接口

高校专业各省录取分数线，多种查询条件，百万级数据。

![gugudata_api_cover](https://static.gugudata.com/api_ceemajorline_v2.jpg)

# 1. 产品功能

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

# 2. API 文档

**API 详情地址:** [https://www.gugudata.com/api/details/ceemajorline](https://www.gugudata.com/api/details/ceemajorline)

**接口地址:** hhttps://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://www.gugudata.com/preview/ceemajorline)

**接口测试:** [https://api.gugudata.com/metadata/ceemajorline/demo](https://api.gugudata.com/metadata/ceemajorline/demo)

# 3. 请求参数

|     参数名     | 参数类型 | 是否必须 |   默认值    |                             备注                             |
| :------------: | :------: | :------: | :---------: | :----------------------------------------------------------: |
|     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、2021。参数默认值为 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.SchoolUUID        |   string    | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 [全国大学高校基础信息](https://www.gugudata.com/api/details/college)、[历年高考高校录取分数线](https://www.gugudata.com/api/details/ceecollegeline) 接口中的 SchoolUUID 进行唯一匹配 |
|       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. 接口 HTTP 响应标准状态码

| 状态码 |  状态码解释  |                             备注                             |
| :----: | :----------: | :----------------------------------------------------------: |
|  200   | 接口正常响应 |           业务状态码参见下方 **接口自定义状态码**            |
|  403   | 请求频率超限 | CDN 层通过 IP 请求频率智能判断，一般的高频请求不会触发此状态码 |

# 6. 接口响应状态码

|              |                  |                                                |
| :----------: | :--------------: | :--------------------------------------------: |
| 自定义状态码 | 自定义状态码解释 |                      备注                      |
|     200      |     正常返回     |                                                |
|     400      |     参数错误     |                                                |
|     402      |   APPKEY 错误    | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
|     403      |     账号欠费     |           请及时关注订单到期短信提醒           |
|     429      |   请求频率受限   |            每秒请求不能超过 100 次             |
|     500      |   接口响应错误   |                                                |

# 7. 开发语言请求示例代码

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

![code demo](https://devopenclub.parryqiu.com/20220312222920.png)


# 8. 常见问题 Q&A

- Q: 数据请求有缓存吗？

  A: 所有的数据都是直接返回的，部分周期性数据在更新周期内数据是缓存的。

- Q: 如何保证请求时 key 的安全性？

  A: 一般建议将对我们 API 的请求放置在您应用的后端服务中发起，您应用的所有前端请求都应该指向您自己的后端服务，这样的架构也更加地纯粹且易维护。

- Q: 接口可以用于哪些开发语言？

  A: 可以使用于所有可以进行网络请求的开发语言，用于您项目快速地进行数据构建。

- Q: 接口的性能可以保证吗？

  A: 接口后台架构和我们给企业提供的商业项目架构一致，您可以通过访问测试接口查看接口相关返回性能与信息。

-----

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

![image-20200716141435988](https://devopenclub.parryqiu.com/20200716141437.png)

咕咕数据基于我们七年来为企业客户提供的千亿级数据存储与性能优化、相关海量基础数据支撑，将合规的部分通用数据、通用功能抽象成产品级数据 API，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了海量数据的存储与运维成本，以及复杂功能的技术门槛与人力开发成本。

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

# **目前已开放的数据接口 API**

- [[条码工具] 通用二维码生成](https://www.gugudata.com/api/details/qrcode)
- [[条码工具] Wi-Fi 无线网二维码生成](https://www.gugudata.com/api/details/wifiqrcode)
- [[条码工具] 通用条形码生成](https://www.gugudata.com/api/details/barcode)
- [[图像识别] 通用文件流 OCR 到文本](https://www.gugudata.com/api/details/imagestreamocr)
- [[图像识别] 通用 OCR](https://www.gugudata.com/api/details/ocr)
- [[图像识别] 通用图片 OCR 到 Word](https://www.gugudata.com/api/details/ocr2word)
- [[图像识别] HTML 转 PDF](https://www.gugudata.com/api/details/html2pdf)
- [[图像识别] HTML 转 Word](https://www.gugudata.com/api/details/html2word)
- [[图像识别] Markdown 转 PDF](https://www.gugudata.com/api/details/markdown2pdf)
- [[图像识别] PDF 解析格式化输出](https://www.gugudata.com/api/details/pdf2format)
- [[区域/坐标] 全国大学高校基础信息](https://www.gugudata.com/api/details/college)
- [[区域/坐标] 地理坐标逆编码](https://www.gugudata.com/api/details/geodecode)
- [[区域/坐标] IP 地址定位](https://www.gugudata.com/api/details/iplocation)
- [[区域/坐标] 全国省市区街道区域信息](https://www.gugudata.com/api/details/chinaregions)
- [[区域/坐标] 地理坐标系转换](https://www.gugudata.com/api/details/coordinateconverter)
- [[元数据/字典] 历年高考省录取分数线](https://www.gugudata.com/api/details/ceeprovince)
- [[元数据/字典] 历年高考高校录取分数线](https://www.gugudata.com/api/details/ceecollegeline)
- [[元数据/字典] 历年高考专业录取分数线](https://www.gugudata.com/api/details/ceemajorline)
- [[元数据/字典] 全国大学高校专业数据](https://www.gugudata.com/api/details/ceemajor)
- [[新闻/资讯] 软件开发技术博文头条](https://www.gugudata.com/api/details/techblogs)
- [[新闻/资讯] 获取任意链接文章正文](https://www.gugudata.com/api/details/fetchcontent)
- [[新闻/资讯] 公众号头条文章](https://www.gugudata.com/api/details/wxarticle)
- [[新闻/资讯] 获取任意链接正文图片](https://www.gugudata.com/api/details/fetchcontentimages)
- [[新闻/资讯] 获取公众号文章封面](https://www.gugudata.com/api/details/wxarticlecover)
- [[新闻/资讯] 幽默笑话大全](https://www.gugudata.com/api/details/joke)
- [[短信/语音] 手机归属地查询](https://www.gugudata.com/api/details/mobileattribution)
- [[短信/语音] 国际手机号码检查纠正](https://www.gugudata.com/api/details/internationalphone)
- [[文字/文本] 中文文本分词](https://www.gugudata.com/api/details/segment)
- [[文字/文本] 中英文排版规范化](https://www.gugudata.com/api/details/formatarticle)
- [[文字/文本] 百万中国对联数据](https://www.gugudata.com/api/details/couplet)
- [[文字/文本] 国际标准书号 ISBN](https://www.gugudata.com/api/details/isbn)
- [[文字/文本] 简体繁体互转](https://www.gugudata.com/api/details/stconvert)
- [[文字/文本] 唐诗宋词大全](https://www.gugudata.com/api/details/chinesepoem)
- [[文字/文本] 关键字摘要智能提取](https://www.gugudata.com/api/details/nlpabstract)
- [[文字/文本] 文本语义相似度检测](https://www.gugudata.com/api/details/nlpsimilarity) 
- [[文字/文本] NLP中文智能纠错](https://www.gugudata.com/api/details/nlpcorrect)
- [[文字/文本] 人工智能对联生成](https://www.gugudata.com/api/details/coupletai)
- [[文字/文本] NLP 语种检测](https://www.gugudata.com/api/details/nlpdetectlanguage)
- [[天气/空气质量] 全国天气预报信息](https://www.gugudata.com/api/details/weatherinfo)
- [[天气/空气质量] 全国实时空气质量指数](https://www.gugudata.com/api/details/airquality)
- [[天气/空气质量] 日出与日落时间](https://www.gugudata.com/api/details/sunriseandsunset)
- [[天气/空气质量] 农历与二十四节气](https://www.gugudata.com/api/details/lunarcalendar)
- [[网站工具] 获取任意站点标题与图标](https://www.gugudata.com/api/details/favicon)
- [[股票行情] 美股实时行情数据](https://www.gugudata.com/api/details/stockusrealtime)
- [[股票行情] 美股历史行情数据](https://www.gugudata.com/api/details/stockus)
- [[股票行情] 美股分时交易数据](https://www.gugudata.com/api/details/stockusperminute)
- [[股票行情] 美股历年基本财务数据](https://www.gugudata.com/api/details/usfundamental)
- [[股票行情] 港股实时行情数据](https://www.gugudata.com/api/details/stockhkrealtime)
- [[股票行情] 港股历史行情数据](https://www.gugudata.com/api/details/stockhk)
- [[股票行情] 港股分时交易数据](https://www.gugudata.com/api/details/stockhkperminute)
- [[股票行情] 港股上市公司公告](https://www.gugudata.com/api/details/stockhkbulletin) 
- [[股票行情] 港股历年三大财务报表](https://www.gugudata.com/api/details/hkannualreport)
- [[股票行情] A 股实时行情数据](https://www.gugudata.com/api/details/stockcnrealtime)
- [[股票行情] A 股历史行情数据](https://www.gugudata.com/api/details/stockcn)
- [[股票行情] A 股分时交易数据](https://www.gugudata.com/api/details/stockcnperminute)
- [[股票行情] A 股历年三大财务报表](https://www.gugudata.com/api/details/annualreport)
- [[股票行情] 中国股票指数数据](https://www.gugudata.com/api/details/stockcnrealtimeindex)
- [[股票行情] A 股个股信息查询](https://www.gugudata.com/api/details/fundamentalinfo)
- [[股票行情] A 股历年财务指标](https://www.gugudata.com/api/details/financialindicator)
- [[股票行情] A 股指数成分数据](https://www.gugudata.com/api/details/stockcnindexcontains)
- [[股票行情] A 股指数历史数据](https://www.gugudata.com/api/details/stockcnindexhistory)
- [[股票行情] A 股盘前数据](https://www.gugudata.com/api/details/stockcnpreopen)
- [[股票行情] A 股分笔交易数据](https://www.gugudata.com/api/details/stockcnticks)
- [[股票行情] A 股交易日历](https://www.gugudata.com/api/details/stockcntradecalendar)
- [[股票行情] 期权实时行情数据](https://www.gugudata.com/api/details/stockcnoptions)
- [[股票行情] 基金基本信息列表](https://www.gugudata.com/api/details/fundinfolist)
- [[股票行情] A 股股票代码](https://www.gugudata.com/api/details/stocksymbols)
- [[股票行情] 指数型基金基本信息](https://www.gugudata.com/api/details/fundbasicindex)
- [[股票行情] 开放式基金净值实时数据](https://www.gugudata.com/api/details/fundopennavrealtime)
- [[股票行情] 开放式基金净值历史数据](https://www.gugudata.com/api/details/fundopennavhistory) 
- [[股票行情] 科创板历史行情数据](https://www.gugudata.com/api/details/stockkcb)
- [[股票行情] 美股粉单实时行情数据](https://www.gugudata.com/api/details/pinksheetsrealtime)
- [[股票行情] 分类美股实时行情数据](https://www.gugudata.com/api/details/usfamous)
- [[股票行情] 公募开放式基金实时数据](https://www.gugudata.com/api/details/fundopenrealtime)
- [[股票行情] 公募开放式基金历史数据](https://www.gugudata.com/api/details/fundopenrealtime)
- [[股票行情] 场内交易基金实时数据](https://www.gugudata.com/api/details/fundopenetfrealtime)
- [[股票行情] 场内交易基金历史数据](https://www.gugudata.com/api/details/fundopenetfhistory)
- [[股票行情] 场内交易基金分时行情](https://www.gugudata.com/api/details/fundhistoryminute)
- [[股票行情] 开放式基金实时排行](https://www.gugudata.com/api/details/fundopenrankinglist)
- [[股票行情] 开放式场内交易基金排行](https://www.gugudata.com/api/details/fundetfopenrankinglist)
- [[股票行情] A 股指数分时行情数据](https://www.gugudata.com/api/details/stockcnindexperminutes)
- [[股票行情] 开放式基金净值估算数据](https://www.gugudata.com/api/details/fundvalueestimation)
- [[股票行情] 港股指数实时行情数据](https://www.gugudata.com/api/details/stockhkindexrealtime)
- [[股票行情] 港股指数历史行情数据](https://www.gugudata.com/api/details/stockhkindexhistory)
- [[股票行情] 港股基础信息数据](https://www.gugudata.com/api/details/stockhkbasicinfo)
- [[股票行情] 国际货币汇率](https://www.gugudata.com/api/details/currencyexchange)
- [[体育/比赛] 历年奥运比赛数据](https://www.gugudata.com/api/details/olympic)