全国大学高校基础信息 - 咕咕数据 API 文档

全国大学高校基础信息
接口详情官网地址: https://www.gugudata.com/api/details/college

提供全国大学高校基础信息

请求方法: GET
接口路径: /location/college
调试地址: https://api.gugudata.com/location/college/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY

keywords (string, 必填): 搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据

pagesize (int, 可选): 每页数据量，参数最大值为 20，用于控制分页

pageindex (int, 可选): 页码，第几页数据，用于控制分页

keywordstrict (boolean, 可选): 控制 keyword 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据

collegecategory (string, 可选): 学院类别，参数默认值为空，不进行筛选。参数可选枚举值：理工类|综合类|师范类|财经类|医药类|艺术类|农林类|军事类|政法类|语言类|体育类|民族类|其它

collegetype (string, 可选): 学院性质，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科|远程教育学院|中外合作办学||独立学院|高职高专|HND项目|其它|成人教育|专科（高职）

is985 (boolean, 可选): 是否为 985 院校，需要参与查询则传参为：true

is211 (boolean, 可选): 是否为 211 院校，需要参与查询则传参为：true

isdualclass (boolean, 可选): 是否为双一流院校，需要参与查询则传参为：true

edulevel (string, 可选): 查询学院学制，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科|本科|专科（高职）|专科|其它

collegeproperty (string, 可选): 查询学院资质，参数默认值为空，不进行筛选。参数可选枚举值: 公办|民办|中外合作办学

返回字段:

DataStatus.StatusCode: 接口返回状态码

DataStatus.StatusDescription: 接口返回状态说明

DataStatus.ResponseDateTime: 接口数据返回时间

DataStatus.DataTotalCount: 此条件下的总数据量，一般用于分页计算

Data.DataId: 数据全局唯一 ID，仅用于标识数据的唯一

Data.SchoolUUID: 咕咕数据平台高校唯一 ID，此唯一 ID 可与历年高考高校录取分数线、历年高考专业录取分数线接口中的 SchoolUUID 进行唯一匹配

Data.CollegeName: 学院名称

Data.Province: 学院所在省份

Data.City: 学院所在城市

Data.District: 学院所在区县

Data.Coordinate: 学院地理坐标经纬度，格式为 [经度,纬度]，地理坐标系为 GCJ-02。需要转换坐标系请调用地理坐标系转换接口

Data.Is985: 是否为 985 院校

Data.Is211: 是否为 211 院校

Data.IsDualClass: 是否为双一流院校

Data.CollegeCategory: 学院类别，值的枚举: 综合类|理工类|师范类|财经类|医药类|艺术类|农林类|军事类|政法类|语言类|体育类|民族类|其它

Data.CollegeTags: 学院标签

Data.EduLevel: 学院学制，值的枚举: 普通本科|本科|专科（高职）|专科|其它

Data.CollegeProperty: 学院资质，值的枚举: 公办|民办|中外合作办学

Data.CollegeCode: 学院编号

Data.Ranking: 全国排名，接口返回的数据结果默认按照此数值进行升序排列

Data.RankingInCategory: 学院所在类别下排名

Data.WebSite: 学院官网

Data.CallNumber: 学院招生电话

Data.Email: 学院招生邮箱

Data.Address: 学院地址

Data.BranchList: 主/分校区名称和地址

Data.CoverImage: 学院校徽

Data.Intro: 学院简介

Data.Expenses: 学院收费（仅供参考）

Data.OldName: 学院旧称

Data.ShortName: 学院简称

Data.MajorList.MajorTitle: 开设专业大类

Data.MajorList.Majors: 此大类下开设的专业

Data.AffiliatedTo: 隶属于

Data.IsMinistryOfEducationDirectlyAffiliated: 是否直属教育部

Data.NumMaster: 硕士点数量

Data.NumDoctor: 博士点数量

Data.GraduateRecommendationQualificationLevel: 研究生推免资格等级

Data.IsDeleted: 废弃数据标识

HTTP 状态码:

200 接口正常响应: 业务状态码请结合响应体中的状态字段判断。

400 请求参数错误: 参数缺失、格式错误或非法组合。

401 鉴权失败: 缺少 APPKEY 或 APPKEY 无效。

403 无权限或额度不可用: 订单到期、权限不足或剩余额度不可用。

404 资源不存在: 请求路径不存在。

405 请求方法不允许: 请求方法与接口定义不匹配。

415 请求内容类型不支持: 文件上传或请求体格式不符合要求。

429 请求频率超限: 触发接口或网关限流策略。

500 服务内部异常: 服务执行异常，请联系技术支持。

502 上游依赖异常: 上游服务响应异常或暂不可用。

业务状态码:

100 正常返回: 暂无说明

101 参数错误: 暂无说明

102 请求频率受限: 每秒请求不能超过 100 次

103 账号欠费: 暂无说明

104 APPKEY 错误: 请检查传递的 APPKEY 是否为开发者中心获取到的值

110 接口响应错误: 暂无说明

接口特性:

2026 年数据已更新；

提供最新全国高校学院基本信息；

总计近 4000 条全国高校精准数据；

每周一次数据自动更新校正；

包含高校各类属性、地理坐标、校徽图片、简称、旧称等信息；

包含高校开设专业列表；

毫秒级响应性能；

全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；

全面兼容 Apple ATS；

全国多节点 CDN 部署；

接口极速响应，多台服务器构建 API 接口负载均衡；

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 0,
    "StatusDescription": "string",
    "ResponseDateTime": "string",
    "DataTotalCount": 0
  },
  "Data": {
    "DataId": "string",
    "SchoolUUID": "string",
    "CollegeName": "string",
    "Province": "string",
    "City": "string",
    "District": "string",
    "Coordinate": "string",
    "CollegeType": "string",
    "Is985": false,
    "Is211": false,
    "IsDualClass": false,
    "CollegeCategory": "string",
    "CollegeTags": [
      "string"
    ],
    "EduLevel": "string",
    "CollegeProperty": "string",
    "CollegeCode": "string",
    "Ranking": 0,
    "RankingInCategory": "string",
    "WebSite": "string",
    "CallNumber": "string",
    "Email": "string",
    "Address": "string",
    "BranchList": [
      "string"
    ],
    "CoverImage": "string",
    "Intro": "string",
    "Expenses": "string",
    "OldName": "string",
    "ShortName": "string",
    "AffiliatedTo": "string",
    "IsMinistryOfEducationDirectlyAffiliated": false,
    "NumMaster": 0,
    "NumDoctor": 0,
    "GraduateRecommendationQualificationLevel": 0,
    "IsDeleted": false,
    "MajorList": {
      "MajorTitle": "string",
      "Majors": [
        "string"
      ]
    }
  }
}