DEV Community

GuGuData
GuGuData

Posted on

全球大学基础信息数据 API 接口

#api #programming #webdev

全球大学基础信息数据 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/global-university

全球大学基础信息数据 API 全球高校多维度信息以及筛选功能，QS排名、世界大学、国际教育等关键词场景常会用到，适合用于字典与基础库查询、教育与行业数据整合与筛选条件补全与业务检索等业务场景，方便开发者直接在应用、脚本或数据流程中接入。

gugudata_api_cover

1. 产品功能

  • 近 7000 所世界大学最新基础数据；
  • 提供全球顶尖大学详细排名信息；
  • 每半个月人工手动定时更新数据；
  • 包含大学基本信息、地理位置、官方网站等数据；
  • 支持按国家、地区、城市多维度筛选；
  • 支持模糊搜索和多字段排序；
  • 数据与咕咕数据平台其他高校接口完全兼容；
  • 毫秒级响应性能；
  • 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
  • 全面兼容 Apple ATS；
  • 全国多节点 CDN 部署；
  • 接口极速响应，多台服务器构建 API 接口负载均衡；

2. API 文档

接口地址: https://api.gugudata.com/college/global-university

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

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/college/global-university?appkey=YOUR_APPKEY&name=YOUR_VALUE&country=YOUR_VALUE&region=YOUR_VALUE&city=YOUR_VALUE&sort=YOUR_VALUE&pagesize=10&pageindex=1

数据预览: https://www.gugudata.com/preview/global-university

接口测试: https://api.gugudata.com/college/global-university/demo

3. 请求参数

参数名 参数类型 是否必须 默认值 备注
appkey string 是 YOUR_APPKEY 付费后获取的 APPKEY
name string 否 YOUR_VALUE 搜索关键字，模糊匹配大学名称或大学中文名称进行模糊匹配，参数值为空则返回所有数据
country string 否 YOUR_VALUE 按国家筛选，支持模糊匹配，参数值为空则不进行筛选
region string 否 YOUR_VALUE 按地区筛选，支持模糊匹配，参数值为空则不进行筛选
city string 否 YOUR_VALUE 按城市筛选，支持模糊匹配，参数值为空则不进行筛选
sort string 否 YOUR_VALUE 排序方式，支持的排序字段：rank（排名）、title（大学名称），排序方向：asc（升序）、desc（降序）。格式：字段名\
pagesize int 否 10 每页数据量，参数最大值为 20，用于控制分页
pageindex int 否 1 页码，第几页数据，用于控制分页

4. 返回参数

参数名 参数类型 备注
DataStatus.StatusCode int 接口返回状态码
DataStatus.StatusDescription string 接口返回状态说明
DataStatus.ResponseDateTime string 接口数据返回时间
DataStatus.DataTotalCount int 此条件下的总数据量，一般用于分页计算
Data.Rank int QS 世界大学排名
Data.UniversityName string 大学名称
Data.UniversityChineseName string 大学中文名称（中文翻译供参考，以英文为准）
Data.Country string 大学所在国家
Data.Region string 大学所在地区
Data.City string 大学所在城市
Data.Logo string 大学校徽图片 URL
Data.InternationalStudents int 国际生数量
Data.SubjectCount int 学科数量
Data.Website string 大学官方网站
Data.SchoolUUID string 咕咕数据平台大学唯一 ID，此唯一 ID 可与其他高校相关接口进行数据关联匹配

5. 错误码说明

状态码 错误说明 备注
100 正常返回 -
101 参数错误 -
102 请求频率受限 每秒请求不能超过 100 次
103 账号欠费 -
104 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值
110 接口响应错误 -

6. 适用场景

  • 适合用于字典与基础库查询，快速补齐产品侧需要的 全球大学基础信息数据 数据能力。
  • 适合用于教育与行业数据整合，减少手工整理、清洗与重复开发成本。
  • 适合用于筛选条件补全与业务检索，将接口结果直接接入后台系统、数据任务或内容处理流程。

7. 相关接口

Top comments (0)