全球 QS 世界大学排名数据

名次为字符串，保留并列与区间表达；各维度名次和得分分别返回。名称检索使用校名及已有校名别名，不提供独立国家或城市筛选。资料按可核实版本使用，不将获取时间视为排名年度。
按校名检索 QS 世界大学排名。
支持中文、英文校名及已支持的校名别名检索，如 MIT、清华和北京大学。
返回高校名称与学校 Logo，便于展示排名列表。
提供地区、国家和城市，帮助定位高校所在地。
返回实际综合名次，并列名次和排名区间以来源公布的字符串展示。
提供学术声誉和雇主声誉的排名与得分。
提供每位教员论文引用指标，便于了解科研表现。
提供师生比例指标，辅助比较教学资源。
提供就业成果指标，支持择校时的多维观察。
返回国际学生、国际教师和国际研究网络的排名与得分。
提供可持续发展指标，与综合排名一同展示。
支持分页和匹配总数，名次与评分分别返回，便于按各自口径展示。

当前接口契约

接口详情：https://www.gugudata.com/api/details/global-university-ranking

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	付费后获取的 APPKEY 此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
name	string	否	无	高校名称检索关键词；支持英文校名、中文校名及已有校名别名，例如 MIT、清华、北京大学；不传时返回分页排名列表。
pageIndex	integer	否	1	分页页码，从 1 开始，默认值为 1。
pageSize	integer	否	10	每页返回条数，默认值为 10，取值范围为 1~20。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口返回状态码。
DataStatus.StatusDescription	string	接口返回状态说明。
DataStatus.ResponseDateTime	string	接口数据返回时间。
DataStatus.DataTotalCount	integer	此条件下的总数据量，一般用于分页计算。
Data.Id	string	咕咕数据平台大学唯一标识。
Data.UniversityName	string	大学英文名称。
Data.UniversityChineseName	string	大学中文名称，海外大学中文译名仅供参考，以英文名称为准。
Data.Region	string	所在大洲或区域。
Data.Country	string	所在国家或地区。
Data.City	string	所在城市。
Data.LogoUrl	string	大学 Logo 图片地址。
Data.Rank	string	QS 综合名次，保持字符串；可能为 =32 等并列名次、1201-1400 等区间或 1401+ 等表达，不等于列表中的顺序编号。
Data.AcademicReputationRank	string	学术声誉指标排名。
Data.AcademicReputationScore	string	学术声誉指标得分。
Data.CitationsPerFacultyRank	string	每位教员论文引用指标的名次；与对应得分区分展示。
Data.CitationsPerFacultyScore	string	每位教员论文引用指标的得分；用于比较科研表现，不是论文数量。
Data.FacultyStudentRatioRank	string	师生比例指标排名。
Data.FacultyStudentRatioScore	string	师生比例指标得分。
Data.EmployerReputationRank	string	雇主声誉指标排名。
Data.EmployerReputationScore	string	雇主声誉指标得分。
Data.EmploymentOutcomesRank	string	就业成果指标排名。
Data.EmploymentOutcomesScore	string	就业成果指标得分。
Data.InternationalStudentRatioRank	string	国际学生比例指标排名。
Data.InternationalStudentRatioScore	string	国际学生比例指标得分。
Data.InternationalResearchNetworkRank	string	国际研究网络指标排名。
Data.InternationalResearchNetworkScore	string	国际研究网络指标得分。
Data.InternationalFacultyRatioRank	string	国际教师比例指标排名。
Data.InternationalFacultyRatioScore	string	国际教师比例指标得分。
Data.SustainabilityRank	string	可持续发展指标排名。
Data.SustainabilityScore	string	可持续发展指标得分。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益过期	HTTP 403
504	凭据无效或无权限	HTTP 401
505	调用额度不足	HTTP 403

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "name=北京大学&pageIndex=1&pageSize=10",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-10-19 22:15:21.077",
    "DataTotalCount": 1
  },
  "Data": [
    {
      "Id": "024ed237acd10562ed824c330a0270d2",
      "UniversityName": "Peking University",
      "UniversityChineseName": "北京大学",
      "Region": "Asia",
      "Country": "China (Mainland)",
      "City": "Beijing",
      "LogoUrl": "https://cdn.gugudata.com/qs/091610fb-71a2-4419-9c8c-5aa3564bc1e9.jpg",
      "Rank": "14",
      "AcademicReputationRank": "13",
      "AcademicReputationScore": "99.5",
      "CitationsPerFacultyRank": "40",
      "CitationsPerFacultyScore": "97.7",
      "FacultyStudentRatioRank": "75",
      "FacultyStudentRatioScore": "92.6",
      "EmployerReputationRank": "28",
      "EmployerReputationScore": "96.6",
      "EmploymentOutcomesRank": "56",
      "EmploymentOutcomesScore": "94.2",
      "InternationalStudentRatioRank": "497",
      "InternationalStudentRatioScore": "23.6",
      "InternationalResearchNetworkRank": "329",
      "InternationalResearchNetworkScore": "79.8",
      "InternationalFacultyRatioRank": "365",
      "InternationalFacultyRatioScore": "50.3",
      "SustainabilityRank": "330",
      "SustainabilityScore": "46.9"
    }
  ]
}

🟠400参数错误（业务码 501）。

🔴503依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明