全国大学高校基础信息 API 接口
提供全国大学高校基础信息。
1. 产品功能
提供最新的全国学院基本信息以及招生数据;
总计近 3000 条全国高校精准数据;
每月一次更新校正数据;
全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
全面兼容 Apple ATS;
全国多节点 CDN 部署;
接口极速响应,多台服务器构建 API 接口负载均衡。
2. API 文档
API 详情地址: https://www.gugudata.com/api/details/college
接口请求地址: https://api.gugudata.com/location/college
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
接口测试: https://api.gugudata.com/location/college/demo
3. 请求参数(如果为 POST 请求,那么参数以 JSON 的格式传递)
参数名参数类型是否必须默认值备注
appkeystring是YOUR_APPKEY付费后获取的 APPKEY
keywordsstring是YOUR_VALUE搜索关键字,模糊匹配高校名称、省市区、高校旧称、地址字段,参数值为空则返回所有数据
pagesizeint否10每页数据量,参数最大值为 100
pageindexint否1页码,第几页数据
keywordstrictstring否false控制 keyword 参数在查询时是否进行模糊查询,true 为精确匹配高校名称,默认值为 false 进行模糊查询
collegecategorystring否学院类别,参数默认值为空,不进行筛选。可选参数为:理工类|综合类|师范类|财经类|医药类|艺术类|农林类|军事类|政法类|语言类|体育类|民族类|其它
4. 返回参数
参数名参数类型备注
DataStatus.StatusCodeint接口返回状态码
DataStatus.StatusDescriptionstring接口返回状态说明
DataStatus.ResponseDateTimestring接口数据返回时间
DataStatus.DataTotalCountint此条件下的总数据量,一般用于分页计算
Data.SchoolUUIDstring咕咕数据平台高校唯一 ID,此唯一 ID 可与 历年高考高校录取分数线、历年高考专业录取分数线 接口中的 SchoolUUID 进行唯一匹配
Data.CollegeNamestring学院名称
Data.Provincestring学院所在省份
Data.Citystring学院所在城市
Data.Districtstring学院所在区县
Data.Coordinatestring学院地理坐标经纬度,格式为 [经度,纬度],地理坐标系为 GCJ-02。需要转换坐标系请调用地理坐标系转换接口
Data.CollegeTypestring学院性质,值的枚举为: 普通本科|独立学院|专科(高职)|高职高专|中外合作办学|成人教育|HND项目|远程教育学院|其它
Data.Is985bool是否为 985 院校
Data.Is211bool是否为 211 院校
Data.IsDualClassbool是否为双一流院校
Data.CollegeCategorystring学院类别,值的枚举为: 综合类|理工类|师范类|财经类|医药类|艺术类|农林类|军事类|政法类|语言类|体育类|民族类|其它
Data.CollegeTagsstring[]学院标签
Data.EduLevelstring学院学制,值的枚举为: 普通本科|本科|专科(高职)|专科|其它
Data.CollegePropertystring学院资质,值的枚举为: 公办|民办|中外合作办学
Data.CollegeCodestring学院编号
Data.Rankingint全国排名
Data.RankingInCategorystring学院所在类别下排名
Data.WebSitestring学院官网
Data.CallNumberstring学院招生电话
Data.Emailstring学院招生邮箱
Data.Addressstring学院地址
Data.CoverImagestring学院校徽
Data.Introstring学院简介
Data.Expensesstring学院收费(仅供参考)
Data.OldNamestring学院旧称
Data.ShortNamestring学院简称
Data.MajorList.MajorTitlestring开设专业大类
Data.MajorList.Majorsstring[]此大类下开设的专业
5. 接口响应状态码
状态码状态码解释备注
100正常返回
501参数错误请检查您传递的参数个数以及参数类型是否匹配
502请求频率受限一般建议每秒请求不超过 100 次
503APPKEY 权限超限/订单到期请至开发者中心检查您的 APPKEY 是否到期或是否权限超限
504APPKEY 错误请检查传递的 APPKEY 是否为开发者中心获取到的值
505请求的次数超出接口限制请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数
900接口响应错误接口可用性为 99.999%,如获取到此状态码请邮件联系我们
6. 开发语言请求示例代码
示例代码包含的开发语言:C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等,其他语言进行对应的 RESTful API 请求实现即可。
咕咕数据,专业的数据提供商,提供专业全面的数据接口、商业数据分析,让数据成为您的生产原料。
咕咕数据基于我们七年来为企业客户提供的海量数据支撑,将部分通用数据、通用功能抽象成产品级 API,大大满足了用户在产品开发过程中对基础数据的需求,同时降低了复杂功能的实现门槛与人力成本。
除了我们已开放的分类数据与接口外,还有海量数据正在整理、清洗、整合、构建中,后期会开放更多的数据与云端功能接口供用户使用。
目前已开放的数据接口 API