QS 排名 API：校名搜索、并列排名与指标得分

GuGuData QS 世界大学排名 API 按英文校名、中文校名及已有校名别名检索，返回综合排名与学术声誉、雇主声誉、国际化等指标。请求使用 GET，pageIndex 从 1 开始，pageSize 最大 20；排名字段需要保留并列或区间文本。

接口概览

项目	说明
请求方法	GET
接口地址	https://api.gugudata.com/metadata/global-university-ranking
返回格式	JSON，UTF-8
调用凭据	对应产品有效 AppKey，示例通过 Header 传递

请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	无	付费后获取的 APPKEY
name	string	否	无	高校名称检索关键词；支持英文校名、中文校名及已有校名别名，例如 MIT、清华、北京大学；不传时返回分页排名列表。
pageIndex	integer	否	1	分页页码，从 1 开始，默认值为 1。
pageSize	integer	否	10	每页返回条数，默认值为 10，取值范围为 1~20。

参数名与大小写按当前文档传递，筛选条件和年份覆盖以实际响应为准。不要把文档示例值当作所有年份或地区通用的业务规则。

请求示例

以下为文档示例，未使用真实凭据执行。YOUR_APPKEY 是占位符，正式调用需要对应产品的有效凭据及权益；价格与套餐以官网为准。中文查询参数使用 URL 编码。

curl --get 'https://api.gugudata.com/metadata/global-university-ranking' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'name=MIT' \
  --data-urlencode 'pageIndex=1' \
  --data-urlencode 'pageSize=10'

返回字段

参数名	参数类型	备注
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	可持续发展指标得分。

字段口径与使用边界

Rank 以字符串返回，可能是并列或区间排名，不应直接转换成单个整数。指标 Rank 与 Score 分别表示名次和得分，不可互换。UniversityChineseName 为参考译名，核对时保留英文名称。当前请求参数没有指定排名年份的字段，不把请求日期或 ResponseDateTime 当作 QS 排名发布年份；跨年度比较前应另外核实数据版本与统计口径。

错误与结果核对

先检查 HTTP 状态，再检查 DataStatus.StatusCode；100 表示业务成功。鉴权、参数、限流与服务异常分别处理，不把失败响应转换成“没有数据”。接口响应时间不等于数据更新时间；空值保留缺口，不补造为零。错误码和 QPS 以当前文档与订单为准。

展示排名时保留原始文本、指标名称及可核实的数据版本；不要把 QS 名次或单项得分直接当作录取概率、学费或就业保证。分页总量读取 DataStatus.DataTotalCount。

官方文档与预览

• 完整接口文档
• 公开数据预览
• 接口 Demo

本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 3 日。用于接口集成与资料核对，实际政策、申请及招生要求以相关机构正式公告为准。