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=Imperial+College+London&country=%e6%97%a0®ion=%e6%97%a0&city=%e6%97%a0&sort=rank%7casc&pagesize=10&pageindex=1
数据预览: https://www.gugudata.com/preview/global-university
接口测试: https://api.gugudata.com/college/global-university/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
付费后获取的 APPKEY |
| name |
string |
否 |
无 |
搜索关键字,模糊匹配大学名称或大学中文名称进行模糊匹配,参数值为空则返回所有数据 |
| country |
string |
否 |
无 |
按国家筛选,支持模糊匹配,参数值为空则不进行筛选 |
| region |
string |
否 |
无 |
按地区筛选,支持模糊匹配,参数值为空则不进行筛选 |
| city |
string |
否 |
无 |
按城市筛选,支持模糊匹配,参数值为空则不进行筛选 |
| sort |
string |
否 |
rank|asc |
排序方式,支持的排序字段:rank(排名)、title(大学名称),排序方向:asc(升序)、desc(降序)。格式:字段名|排序方向 |
| pagesize |
integer |
否 |
10 |
每页数据量,参数最大值为 20,用于控制分页 |
| pageindex |
integer |
否 |
1 |
页码,第几页数据,用于控制分页 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次实际业务参数,不含鉴权凭据;Demo 展示对应样例输入。 |
| DataStatus.StatusCode |
integer |
接口返回状态码 |
| DataStatus.StatusDescription |
string |
接口返回状态说明 |
| DataStatus.ResponseDateTime |
string |
接口数据返回时间 |
| DataStatus.DataTotalCount |
integer |
此条件下的总数据量,一般用于分页计算 |
| Data.Rank |
integer |
此高校资料集中的数值排名。资料集与全球排名查询的来源版本可能不同,不作跨集同步承诺。 |
| Data.UniversityName |
string |
大学名称 |
| Data.UniversityChineseName |
string |
大学中文名称(中文翻译供参考,以英文为准) |
| Data.Country |
string |
大学所在国家 |
| Data.Region |
string |
大学所在地区 |
| Data.City |
string |
大学所在城市 |
| Data.Logo |
string |
大学校徽图片 URL |
| Data.InternationalStudents |
integer |
来源提供的国际学生数量;未提供时沿用数值 0 的兼容占位,不代表已核实为零人。 |
| Data.SubjectCount |
integer |
高校学科数量,用于展示学科设置概况;不等同于专业总数。 |
| Data.Website |
string |
高校官网地址,可用于核对学校及招生信息。 |
| Data.SchoolUUID |
string |
咕咕数据平台大学唯一 ID,可用于查询该大学专业明细。 |
| Data.InstitutionType |
string |
学校性质。当前没有可靠性质资料时返回空字符串,不据此判断公办或私立。 |
| Data.ProgrammeCount |
integer |
该大学可查询的专业总数;没有专业明细时返回 0。 |
| Data.ProgrammeDataAvailable |
boolean |
是否存在可查询的专业明细数据。 |
| Data.Programmes |
array |
当前大学内嵌的专业摘要列表,最多返回 20 条;完整专业列表请使用关联接口分页查询。 |
| Data.Programmes.ProgrammeId |
string |
专业唯一 ID。 |
| Data.Programmes.ProgrammeName |
string |
专业名称。 |
| Data.Programmes.StudyLevel |
string |
学习层级,例如 Undergraduate、Postgraduate、PhD、MBA。 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "name=Imperial College London&country=®ion=&city=&sort=rank|asc&pageIndex=1&pageSize=10",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-19 22:15:19.439",
"DataTotalCount": 1
},
"Data": [
{
"Rank": 2,
"Website": "http://www.imperial.ac.uk",
"UniversityName": "Imperial College London",
"UniversityChineseName": "帝国理工学院",
"Logo": "https://cdn.gugudata.com/qs/8712ae98-f322-4e6c-b4a8-6d0b1dd0b42c.jpg",
"Region": "Europe",
"Country": "United Kingdom",
"City": "London",
"InternationalStudents": 9230,
"SubjectCount": 14,
"ProgrammeCount": 214,
"ProgrammeDataAvailable": true,
"Programmes": [
{
"ProgrammeId": "c4b5c5d0466181f56402b172a1547809",
"ProgrammeName": "BEng Computing",
"StudyLevel": "Undergraduate"
},
{
"ProgrammeId": "a06fc8dcac41af8e7f6ab73823dfa78c",
"ProgrammeName": "BEng Electrical and Electronic Engineering",
"StudyLevel": "Undergraduate"
},
{
"ProgrammeId": "29081e7c8b58041f5bae1a9ed5c001c1",
"ProgrammeName": "BEng Electronic and Information Engineering",
"StudyLevel": "Undergraduate"
}
],
"SchoolUUID": "1f3b0ca2d2ebea54a9b63ec99b1497dc",
"InstitutionType": ""
}
]
}