{"DataStatus":{"RequestParameter":"url=https://www.gugudata.com/api/details/global-university-ranking","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-06-25 06:37:47.933","DataTotalCount":1},"Data":"菜单 [ ![咕咕数据](https://static.gugudata.com/gugudata_logo.svg \"GuGuData\") ](https://www.gugudata.com/%20%22%E5%92%95%E5%92%95%E6%95%B0%E6%8D%AE%E9%A6%96%E9%A1%B5%22) \n\n* [首页](https://www.gugudata.com/%20%22%E7%BD%91%E7%AB%99%E9%A6%96%E9%A1%B5%22)\n* [数据服务](https://www.gugudata.com/api/all/9/0/9/0/%E4%B8%8D%E9%99%90%20%22%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E6%95%B0%E6%8D%AE%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%22)\n* [智能搜索](https://www.gugudata.com/search%20%22%E4%BD%BF%E7%94%A8%20AI%20%E6%99%BA%E8%83%BD%E6%90%9C%E7%B4%A2%E4%B8%8E%E6%9F%A5%E8%AF%A2%E6%9F%A5%E6%89%BE%E6%8E%A5%E5%8F%A3%22)\n* [MCP 服务](https://www.gugudata.com/mcp%20%22%E6%9F%A5%E7%9C%8B%20MCP%20%E6%9C%8D%E5%8A%A1%22)\n* [开发者中心](https://www.gugudata.com/signin?returnurl=%2Fportal%2F%20%22%E8%BF%9B%E5%85%A5%E5%BC%80%E5%8F%91%E8%80%85%E4%B8%AD%E5%BF%83%22)\n* [接口状态](https://www.gugudata.com/status%20%22%E6%9F%A5%E7%9C%8B%E6%8E%A5%E5%8F%A3%E5%AE%9E%E6%97%B6%E7%8A%B6%E6%80%81%22)\n* [联系我们](https://www.gugudata.com/contact%20%22%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%22)\n* [接口文档](https://doc.gugudata.com \"查看接口文档\")\n* [工程服务](https://engineering.gugudata.com \"工程服务\")\n\n* [登录](https://www.gugudata.com/signin%20%22%E7%94%A8%E6%88%B7%E7%99%BB%E5%BD%95%22)\n* /\n* [注册](https://www.gugudata.com/signup%20%22%E6%B3%A8%E5%86%8C%E6%96%B0%E7%94%A8%E6%88%B7%22)\n\n1. [首页](https://www.gugudata.com/%20%22%E8%BF%94%E5%9B%9E%E9%A6%96%E9%A1%B5%22)\n2. ›\n3. [数据服务](https://www.gugudata.com/api/all/9/0/9/0/%E4%B8%8D%E9%99%90%20%22%E6%9F%A5%E7%9C%8B%E5%85%A8%E9%83%A8%E6%95%B0%E6%8D%AE%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%22)\n4. ›\n5. [教育/高考](https://www.gugudata.com/api/metadata/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%20%E6%95%99%E8%82%B2/%E9%AB%98%E8%80%83%20%E5%88%86%E7%B1%BB%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%8E%A5%E5%8F%A3%22)\n6. ›\n7. 全球 QS 世界大学排名数据\n\n![全球 QS 世界大学排名数据](https://static.gugudata.com/api_global_university_ranking.png) \n\n# ![稳定提供服务 10 年](https://www.gugudata.com/images/top-vendor.svg%20%22%E7%A8%B3%E5%AE%9A%E6%8F%90%E4%BE%9B%E6%9C%8D%E5%8A%A1%2010%20%E5%B9%B4%22)全球 QS 世界大学排名数据\n\n* [教育/高考](https://www.gugudata.com/api/metadata/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%20%E6%95%99%E8%82%B2/%E9%AB%98%E8%80%83%20%E5%88%86%E7%B1%BB%E4%B8%8B%E7%9A%84%E6%89%80%E6%9C%89%E6%8E%A5%E5%8F%A3%22)\n* 详细排名指标和得分信息\n* 全球排名 / 高等教育\n* [高等教育](https://www.gugudata.com/api/all/9/0/9/0/%E9%AB%98%E7%AD%89%E6%95%99%E8%82%B2)\n* 数据校验更新于 11 小时前\n\n[ 1999元/年 限时折扣 **999元/年** 立即购买 ](https://www.gugudata.com/order/global-university-ranking%20%22%E8%B4%AD%E4%B9%B0%20%E5%85%A8%E7%90%83%20QS%20%E4%B8%96%E7%95%8C%E5%A4%A7%E5%AD%A6%E6%8E%92%E5%90%8D%E6%95%B0%E6%8D%AE%20%E6%8E%A5%E5%8F%A3%E6%9C%8D%E5%8A%A1%22) [接口数据预览](https://www.gugudata.com/preview/global-university-ranking%20%22%E9%A2%84%E8%A7%88%20%E5%85%A8%E7%90%83%20QS%20%E4%B8%96%E7%95%8C%E5%A4%A7%E5%AD%A6%E6%8E%92%E5%90%8D%E6%95%B0%E6%8D%AE%20%E6%8E%A5%E5%8F%A3%E8%BF%94%E5%9B%9E%E6%95%B0%E6%8D%AE%22) [告诉大模型怎么用](https://www.gugudata.com/api/details/global-university-ranking/llm%20%22%E6%8A%8A%20%E5%85%A8%E7%90%83%20QS%20%E4%B8%96%E7%95%8C%E5%A4%A7%E5%AD%A6%E6%8E%92%E5%90%8D%E6%95%B0%E6%8D%AE%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E%E4%BA%A4%E7%BB%99%E5%A4%A7%E6%A8%A1%E5%9E%8B%E4%BD%BF%E7%94%A8%22) \n\n* [API 功能](#anchor%5Ffeature \"查看 API 功能特性\")\n* [API 文档](#anchor%5Fapi \"查看 API 接口文档\")\n* [鉴权方式](#anchor%5Fauth \"查看 API 鉴权方式\")\n* [接口状态码](#anchor%5Fsystemcode \"查看接口 HTTP 响应状态码\")\n* [请求示例代码](#anchor%5Fcode \"查看多语言请求示例代码\")\n* [常见问题 Q\u0026A](#anchor%5Fqa \"查看常见问题解答\")\n* [服务协议](#anchor%5Fagreement \"查看服务协议\")\n* [技术支持](#anchor%5Fcontact \"查看技术支持联系方式\")\n\n* ## API 功能  \n   * 提供全球 QS 世界大学排名数据；  \n   * 每个季度定时更新数据；  \n   * 支持按学校名称模糊搜索；  \n   * 包含详细的排名指标和得分信息；  \n   * 支持分页查询；  \n   * 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；  \n   * 全面兼容 Apple ATS；  \n   * 全国多节点 CDN 部署；  \n   * 接口极速响应，多台服务器构建 API 接口负载均衡。  \n   * [接口调用状态与状态监控](https://www.gugudata.com/status%20%22%E6%9F%A5%E7%9C%8B%E6%8E%A5%E5%8F%A3%E8%B0%83%E7%94%A8%E7%8A%B6%E6%80%81%E4%B8%8E%E5%AE%9E%E6%97%B6%E7%9B%91%E6%8E%A7%22)\n* ## API 文档  \n**接口地址:** https://api.gugudata.com/metadata/global-university-ranking  \n**返回格式:** application/json; charset=utf-8  \n**请求方式:** GET  \n**请求协议:** HTTPS  \n**请求示例:** https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR\\_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10  \n**数据预览:** [https://www.gugudata.com/preview/global-university-ranking](https://www.gugudata.com/preview/global-university-ranking%20%22%E9%A2%84%E8%A7%88%20%E5%85%A8%E7%90%83%20QS%20%E4%B8%96%E7%95%8C%E5%A4%A7%E5%AD%A6%E6%8E%92%E5%90%8D%E6%95%B0%E6%8D%AE%20%E6%8E%A5%E5%8F%A3%E8%BF%94%E5%9B%9E%E6%95%B0%E6%8D%AE%22)  \n**接口测试:** [ https://api.gugudata.com/metadata/global-university-ranking/demo](https://api.gugudata.com/metadata/global-university-ranking/demo \"测试 全球 QS 世界大学排名数据 接口\")  \n**OpenAPI:** \u003chttps://www.gugudata.com/openapi/gugudata.openapi.3.1.json\u003e  \n请求参数（GET 请求方式可参见下方示例代码）  \n| 参数名       | 参数类型    | 是否必须             | 默认值                   | 备注                                                                           |  \n| --------- | ------- | ---------------- | --------------------- | ---------------------------------------------------------------------------- |  \n| appkey    | string  | 是                | YOUR\\_APPKEY          | 付费后获取的 APPKEY。文档示例默认通过 Query 参数 appkey 传递；历史 Form 或 JSON body 中的 appkey 仍兼容。 |  \n| name      | string  | \u003cspan\u0027\u003e否\u003c/span\u0027\u003e | 学校名称，支持模糊搜索，不传则返回所有数据 |                                                                              |  \n| pageIndex | integer | \u003cspan\u0027\u003e否\u003c/span\u0027\u003e | 1                     | 分页参数，第几页，默认值为1                                                               |  \n| pageSize  | integer | \u003cspan\u0027\u003e否\u003c/span\u0027\u003e | 10                    | 分页参数，每页条数，取值范围在 1 \\~ 20 之间（含）                                                |  \n返回参数  \n| 参数名                                    | 参数类型    | 备注                              |  \n| -------------------------------------- | ------- | ------------------------------- |  \n| DataStatus.RequestParameter            | string  | 请求参数字符串                         |  \n| DataStatus.StatusCode                  | integer | 接口返回状态码                         |  \n| DataStatus.StatusDescription           | string  | 接口返回状态说明                        |  \n| DataStatus.ResponseDateTime            | string  | 接口数据返回时间                        |  \n| DataStatus.DataTotalCount              | integer | 此条件下的总数据量，一般用于分页计算              |  \n| Data.Id                                | string  | 咕咕数据平台大学唯一标识                    |  \n| Data.UniversityName                    | string  | 大学名称                            |  \n| Data.UniversityChineseName             | string  | 大学中文名称（因为部分海外大学音译，仅供参考，以英文名称为准） |  \n| Data.Region                            | string  | 所在地区                            |  \n| Data.Country                           | string  | 所在国家                            |  \n| Data.City                              | string  | 所在城市                            |  \n| Data.LogoUrl                           | string  | 大学 Logo 图片地址                    |  \n| Data.Rank                              | string  | 综合排名                            |  \n| Data.AcademicReputationRank            | string  | 学术声誉排名                          |  \n| Data.AcademicReputationScore           | string  | 学术声誉得分                          |  \n| Data.CitationsPerFacultyRank           | string  | 每名教师的引用率排名                      |  \n| Data.CitationsPerFacultyScore          | string  | 每名教师的引用率得分                      |  \n| Data.FacultyStudentRatioRank           | string  | 师生比例排名                          |  \n| Data.FacultyStudentRatioScore          | string  | 师生比例得分                          |  \n| Data.EmployerReputationRank            | string  | 雇主声誉排名                          |  \n| Data.EmployerReputationScore           | string  | 雇主声誉得分                          |  \n| Data.EmploymentOutcomesRank            | string  | 就业成果排名                          |  \n| Data.EmploymentOutcomesScore           | string  | 就业成果得分                          |  \n| Data.InternationalStudentRatioRank     | string  | 国际学生比例排名                        |  \n| Data.InternationalStudentRatioScore    | string  | 国际学生比例得分                        |  \n| Data.InternationalResearchNetworkRank  | string  | 国际研究网络排名                        |  \n| Data.InternationalResearchNetworkScore | string  | 国际研究网络得分                        |  \n| Data.InternationalFacultyRatioRank     | string  | 国际教师比例排名                        |  \n| Data.InternationalFacultyRatioScore    | string  | 国际教师比例得分                        |  \n| Data.SustainabilityRank                | string  | 可持续发展排名                         |  \n| Data.SustainabilityScore               | string  | 可持续发展得分                         |\n* ## 鉴权方式  \n接口支持以下 AppKey 传递方式，任选一种即可；已有请求示例、Postman 集合和历史代码仍可继续使用原来的 appkey 参数方式。  \n| 位置          | 写法                                 | 说明                                  |  \n| ----------- | ---------------------------------- | ----------------------------------- |  \n| HTTP Header | X-GUGUDATA-APPKEY: YOUR\\_APPKEY    | 推荐方式，适合服务端接入和统一封装。                  |  \n| HTTP Header | X-API-Key: YOUR\\_APPKEY            | 通用 API Key Header，便于和常见 API 客户端集成。  |  \n| HTTP Header | Authorization: Bearer YOUR\\_APPKEY | 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。 |  \n| Query 参数    | ?appkey=YOUR\\_APPKEY               | 兼容现有示例、Postman 集合、浏览器调试和历史代码。       |  \n部分历史 POST 接口仍兼容表单或 JSON body 中的 appkey；新接入建议优先使用 Header 或 Query 参数。\n* ## 接口常见 HTTP 响应状态码  \n以下为接口调用中常见的 HTTP 传输层状态码，不等同于响应体内的业务状态码；完整状态码注册表以 IANA HTTP Status Code Registry 为准。  \n| 状态码 | 状态码解释     | 备注                                                                              |  \n| --- | --------- | ------------------------------------------------------------------------------- |  \n| 200 | 请求成功      | HTTP 请求已成功处理；业务状态请结合响应体中的自定义业务码判断。                                              |  \n| 201 | 资源已创建     | 创建类接口请求成功，并已生成对应资源。                                                             |  \n| 202 | 请求已接受     | 请求已被接受处理，结果可能异步完成。                                                              |  \n| 204 | 无响应内容     | 请求成功但响应体为空，适用于无需返回数据的操作。                                                        |  \n| 304 | 资源未变更     | 配合缓存或条件请求使用，表示可继续使用本地缓存。                                                        |  \n| 400 | 请求参数错误    | 请求参数缺失、格式错误或参数组合不合法。                                                            |  \n| 401 | 认证失败      | 缺少、无效或未通过认证的访问凭证（如 AppKey）。                                                     |  \n| 403 | 无权限访问     | 订单到期、权限不足或接口额度不可用。                                                              |  \n| 404 | 资源不存在     | 请求路径不存在。                                                                        |  \n| 405 | 请求方法不允许   | 当前路径不支持该 HTTP 方法。                                                               |  \n| 408 | 请求超时      | 客户端请求在服务端等待时间内未完成，可稍后重试。                                                        |  \n| 409 | 请求冲突      | 请求与当前资源状态冲突，调整参数或业务状态后重试。                                                       |  \n| 413 | 请求内容过大    | 上传文件或请求体超过接口限制。                                                                 |  \n| 414 | 请求地址过长    | 请求 URL 超过服务端可处理长度，建议减少查询参数或改用 POST。                                             |  \n| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。                                                             |  \n| 422 | 请求语义错误    | 请求格式正确，但参数取值、语义或业务约束无法处理。                                                       |  \n| 429 | 请求频率受限    | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |  \n| 431 | 请求头过大     | 请求头字段过大或过多，建议精简 Header 后重试。                                                     |  \n| 500 | 服务器内部错误   | 服务端处理异常，请稍后重试。                                                                  |  \n| 502 | 网关或上游错误   | 网关或代理从上游服务收到异常响应。                                                               |  \n| 503 | 服务暂时不可用   | 服务维护、容量保护或依赖异常导致暂时不可用，请稍后重试。                                                    |  \n| 504 | 网关超时      | 网关等待上游服务响应超时，可稍后重试或降低请求复杂度。                                                     |\n* ## 接口自定义业务状态码  \n| 业务状态码 | 业务状态码解释   | 备注                                                                              |  \n| ----- | --------- | ------------------------------------------------------------------------------- |  \n| 100   | 正常返回      |                                                                                 |  \n| 101   | 参数错误      |                                                                                 |  \n| 102   | 请求频率受限    | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |  \n| 103   | 账号欠费      |                                                                                 |  \n| 104   | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值                                                     |\n* ## 请求示例代码  \n   * [cURL 请求示例](#curl \"查看 cURL 请求示例\")  \n   * [C 请求示例](#c \"查看 C 请求示例\")  \n   * [C# 请求示例](#csharp \"查看 C# 请求示例\")  \n   * [Go 请求示例](#go \"查看 Go 请求示例\")  \n   * [Java 请求示例](#java \"查看 Java 请求示例\")  \n   * [jQuery 请求示例](#jquery \"查看 jQuery 请求示例\")  \n   * [Node.js 请求示例](#nodejs \"查看 Node.js 请求示例\")  \n   * [Objective-C 请求示例](#objectivec \"查看 Objective-C 请求示例\")  \n   * [PHP 请求示例](#php \"查看 PHP 请求示例\")  \n   * [Python 请求示例](#python \"查看 Python 请求示例\")  \n   * [Ruby 请求示例](#ruby \"查看 Ruby 请求示例\")  \n   * [Swift 请求示例](#swift \"查看 Swift 请求示例\")  \n```bash  \ncurl --location --request GET \u0027https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\u0027  \n```  \n```c  \n#include \u003ccurl/curl.h\u003e  \nint main(void) {  \n  CURL *curl = curl_easy_init();  \n  if (curl) {  \n    curl_easy_setopt(curl, CURLOPT_URL, \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\");  \n    curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, \"GET\");  \n    curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);  \n    CURLcode res = curl_easy_perform(curl);  \n    (void)res;  \n    curl_easy_cleanup(curl);  \n  }  \n  return 0;  \n}  \n```  \n```csharp  \nusing System;  \nusing System.Collections.Generic;  \nusing System.IO;  \nusing System.Net.Http;  \nvar client = new HttpClient();  \nvar request = new HttpRequestMessage(HttpMethod.Get, \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\");  \nvar response = client.SendAsync(request).Result;  \nConsole.WriteLine(response.Content.ReadAsStringAsync().Result);  \n```  \n```go  \npackage main  \nimport (  \n  \"fmt\"  \n  \"io\"  \n  \"net/http\"  \n)  \nfunc main() {  \n  url := \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\"  \n  req, err := http.NewRequest(\"GET\", url, nil)  \n  if err != nil {  \n    fmt.Println(err)  \n    return  \n  }  \n  res, err := http.DefaultClient.Do(req)  \n  if err != nil {  \n    fmt.Println(err)  \n    return  \n  }  \n  defer res.Body.Close()  \n  body, err := io.ReadAll(res.Body)  \n  if err != nil {  \n    fmt.Println(err)  \n    return  \n  }  \n  fmt.Println(string(body))  \n}  \n```  \n```java  \nOkHttpClient client = new OkHttpClient().newBuilder().build();  \nRequest request = new Request.Builder()  \n  .url(\"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\")  \n  .method(\"GET\", null)  \n  .build();  \nResponse response = client.newCall(request).execute();  \nSystem.out.println(response.body().string());  \n```  \n```javascript  \n$.ajax({  \n  url: \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\",  \n  method: \"GET\",  \n}).done(function (response) {  \n  console.log(response);  \n});  \n```  \n```javascript  \nconst https = require(\"node:https\");  \nconst url = \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\";  \nconst request = https.request(url, { method: \"GET\" }, handleResponse);  \nrequest.on(\"error\", console.error);  \nrequest.end();  \nfunction handleResponse(response) {  \n  const chunks = [];  \n  response.on(\"data\", function (chunk) {  \n    chunks.push(chunk);  \n  });  \n  response.on(\"end\", function () {  \n    console.log(Buffer.concat(chunks).toString(\"utf8\"));  \n  });  \n}  \n```  \n```objectivec  \n#import \u003cFoundation/Foundation.h\u003e  \nNSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@\"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\"]];  \n[request setHTTPMethod:@\"GET\"];  \nNSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {  \n  if (error) {  \n    NSLog(@\"%@\", error);  \n    return;  \n  }  \n  NSLog(@\"%@\", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);  \n}];  \n[task resume];  \n```  \n```php  \n\u003c?php  \n$curl = curl_init();  \ncurl_setopt_array($curl, array(  \n  CURLOPT_URL =\u003e \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\",  \n  CURLOPT_RETURNTRANSFER =\u003e true,  \n  CURLOPT_FOLLOWLOCATION =\u003e true,  \n  CURLOPT_CUSTOMREQUEST =\u003e \"GET\",  \n));  \n$response = curl_exec($curl);  \ncurl_close($curl);  \necho $response;  \n```  \n```python  \nimport requests  \nurl = \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\"  \nresponse = requests.request(\"GET\", url)  \nprint(response.text)  \n```  \n```ruby  \nrequire \"uri\"  \nrequire \"net/http\"  \nurl = URI(\"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\")  \nhttps = Net::HTTP.new(url.host, url.port)  \nhttps.use_ssl = true  \nrequest = Net::HTTP::Get.new(url)  \nresponse = https.request(request)  \nputs response.read_body  \n```  \n```swift  \nimport Foundation  \nlet semaphore = DispatchSemaphore(value: 0)  \nvar request = URLRequest(url: URL(string: \"https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY\u0026name=\u0026pageIndex=1\u0026pageSize=10\")!, timeoutInterval: .infinity)  \nrequest.httpMethod = \"GET\"  \nlet task = URLSession.shared.dataTask(with: request) { data, response, error in  \n  defer { semaphore.signal() }  \n  guard let data = data else {  \n    print(String(describing: error))  \n    return  \n  }  \n  print(String(data: data, encoding: .utf8)!)  \n}  \ntask.resume()  \nsemaphore.wait()  \n```  \n[![Swagger](https://www.gugudata.com/images/swagger.svg)Swagger 文档](/swagger \"打开 Swagger 文档页面\") [在 Postman 中测试运行](https://www.postman.com/gugudata/gugudata-official/collection/1163860-ee114343-4622-4a54-a39b-994173c27dac/?action=share\u0026creator=1163860\u0026active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35 \"在 Postman 中导入并运行此接口\") [![Apifox](https://www.gugudata.com/images/apifox.svg)在 Apifox 中测试运行](https://doc.gugudata.com/ \"在 Apifox 中导入并运行此接口\") [打开 LLM 页面](https://www.gugudata.com/api/details/global-university-ranking/llm%20%22%E6%89%93%E5%BC%80%E5%BD%93%E5%89%8D%E6%8E%A5%E5%8F%A3%E7%9A%84%20LLM%20Markdown%20%E9%A1%B5%E9%9D%A2%22) 复制 LLM.md\n* ## 常见问题 Q\u0026A  \n   * **Q: 数据请求有缓存吗？**  \n   A: 接口默认以实时响应为目标。对于日更、月更等具备明确更新周期的数据，会在数据周期内采用缓存与预热策略，以提升响应速度和稳定性；实时查询类接口则以接口说明中的更新频率为准。建议业务侧结合数据时效要求设置本地缓存与重试策略，避免高频重复请求。  \n   * **Q: 如何保证请求时 AppKey 的安全性？**  \n   A: 建议将 AppKey 保存在服务端环境中，由后端统一调用 API，再向前端或业务系统返回必要结果。不要把 AppKey 写入网页、App 客户端或公开仓库；生产环境建议按系统或业务线拆分 AppKey，并保留调用日志，便于权限控制、审计与问题排查。  \n   * **Q: 接口可以用于哪些开发语言？**  \n   A: 只要支持 HTTPS 请求的语言和框架均可接入，包括 Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等。推荐由后端统一封装调用逻辑，集中处理鉴权、缓存、限流、重试和错误码映射，让 Web、App、AI Agent、内部系统和自动化任务复用同一套数据能力。  \n   * **Q: 接口的性能可以保证吗？**  \n   A: GuGuData API 按生产环境标准部署，持续关注接口稳定性、响应速度与可用性。实际响应时间会受接口类型、请求参数、数据源更新和网络环境影响；建议生产接入前进行联调与压测，并设置合理的超时、重试、降级和告警策略。批量处理或高并发场景可提前评估 QPS、白名单和专属容量方案。\n* ## 服务协议与免责声明  \n购买或使用 GuGuData API 服务前，请充分阅读服务协议与免责声明。两个页面均支持在浏览器中快速导出 PDF，便于内部归档、评审和合规留存。  \n[查看服务协议](https://www.gugudata.com/license%20%22%E6%9F%A5%E7%9C%8B%E6%9C%8D%E5%8A%A1%E5%8D%8F%E8%AE%AE%22) [查看服务免责声明](https://www.gugudata.com/disclaimer%20%22%E6%9F%A5%E7%9C%8B%E6%9C%8D%E5%8A%A1%E5%85%8D%E8%B4%A3%E5%A3%B0%E6%98%8E%22)\n* ## 技术支持  \n   * **技术支持邮箱:** support@gugudata.com  \n   * **微信客服:** [客服链接](https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7 \"打开微信客服页面\")\n* ## 专业软件开发与系统工程服务  \nGuGuData 官方认证工程合作伙伴，专注企业级数据接口集成、AI 工程化与大规模数据处理。团队深度理解 GuGuData 数据接口体系，具备海量数据采集、治理、检索与高并发接口服务经验，可围绕业务场景构建 AI Agent、MCP 接入、智能工作流和生产级数据应用，让数据能力稳定进入现有流程、内部平台和核心业务系统。  \n[了解工程服务](https://engineering.gugudata.com/?utm%5Fsource=gugudata.com\u0026utm%5Fmedium=api%5Fdetail%5Fsupport\u0026utm%5Fcampaign=engineering%5Fservices%5Ftrial\u0026utm%5Fcontent=global-university-ranking \"了解专业软件开发与系统工程服务\")\n\n[购买数据调用](https://www.gugudata.com/order/global-university-ranking%20%22%E8%B4%AD%E4%B9%B0%20%E5%85%A8%E7%90%83%20QS%20%E4%B8%96%E7%95%8C%E5%A4%A7%E5%AD%A6%E6%8E%92%E5%90%8D%E6%95%B0%E6%8D%AE%20%E6%8E%A5%E5%8F%A3%E6%9C%8D%E5%8A%A1%22) [邮件咨询 (7\\*24小时)](mailto:support@gugudata.com \"发送邮件咨询技术支持\") [微信客服联系 (工作日)](https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7 \"联系微信客服\") [需要软件工程开发服务？](https://engineering.gugudata.com/?utm%5Fsource=gugudata.com\u0026utm%5Fmedium=api%5Fdetail%5Fbottom%5Fcta\u0026utm%5Fcampaign=engineering%5Fservices%5Ftrial\u0026utm%5Fcontent=global-university-ranking \"了解专业软件开发与系统工程服务\") \n\n![微信客服](https://static.gugudata.com/wechat-services.png) \n\n## 业务相关接口推荐\n\n[ ![高考教育信息智能助手](https://static.gugudata.com/api-cover-gaokao-chat.png) ](https://www.gugudata.com/api/details/gaokao-chat%20%22%E6%9F%A5%E7%9C%8B%20%E9%AB%98%E8%80%83%E6%95%99%E8%82%B2%E4%BF%A1%E6%81%AF%E6%99%BA%E8%83%BD%E5%8A%A9%E6%89%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n\n[高考教育信息智能助手](https://www.gugudata.com/api/details/gaokao-chat%20%22%E6%9F%A5%E7%9C%8B%20%E9%AB%98%E8%80%83%E6%95%99%E8%82%B2%E4%BF%A1%E6%81%AF%E6%99%BA%E8%83%BD%E5%8A%A9%E6%89%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n* 高考教育信息智能问答助手\n* 智能问答 / 知识库检索 / 多轮对话\n* 9999元/年限时折扣 **4999元/年**\n\n[ 查看详情：高考教育信息智能助手 ](https://www.gugudata.com/api/details/gaokao-chat%20%22%E6%9F%A5%E7%9C%8B%20%E9%AB%98%E8%80%83%E6%95%99%E8%82%B2%E4%BF%A1%E6%81%AF%E6%99%BA%E8%83%BD%E5%8A%A9%E6%89%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) 数据校验更新于 36 分钟前 \n\n![50% 折扣](https://static.gugudata.com/icon_dis_50.png \"限时 50% 折扣中...\") \n\n[ ![基于模型的高校录取概率预测](https://static.gugudata.com/api-cover-admission-predict.png) ](https://www.gugudata.com/api/details/admission-predict%20%22%E6%9F%A5%E7%9C%8B%20%E5%9F%BA%E4%BA%8E%E6%A8%A1%E5%9E%8B%E7%9A%84%E9%AB%98%E6%A0%A1%E5%BD%95%E5%8F%96%E6%A6%82%E7%8E%87%E9%A2%84%E6%B5%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n\n[基于模型的高校录取概率预测](https://www.gugudata.com/api/details/admission-predict%20%22%E6%9F%A5%E7%9C%8B%20%E5%9F%BA%E4%BA%8E%E6%A8%A1%E5%9E%8B%E7%9A%84%E9%AB%98%E6%A0%A1%E5%BD%95%E5%8F%96%E6%A6%82%E7%8E%87%E9%A2%84%E6%B5%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n* 基于历年院校/专业录取线、分差特征与概率校准结果，为高考志愿填报提供录取概率参考\n* AI预测 / 高考志愿 / 录取概率\n* 9999元/年限时折扣 **4999元/年**\n\n[ 查看详情：基于模型的高校录取概率预测 ](https://www.gugudata.com/api/details/admission-predict%20%22%E6%9F%A5%E7%9C%8B%20%E5%9F%BA%E4%BA%8E%E6%A8%A1%E5%9E%8B%E7%9A%84%E9%AB%98%E6%A0%A1%E5%BD%95%E5%8F%96%E6%A6%82%E7%8E%87%E9%A2%84%E6%B5%8B%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) 数据校验更新于 28 分钟前 \n\n![50% 折扣](https://static.gugudata.com/icon_dis_50.png \"限时 50% 折扣中...\") \n\n[ ![职教高考及高职分类招生控制线](https://static.gugudata.com/api_cee_college_line.png) ](https://www.gugudata.com/api/details/vocationalcontrollines%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E6%95%99%E9%AB%98%E8%80%83%E5%8F%8A%E9%AB%98%E8%81%8C%E5%88%86%E7%B1%BB%E6%8B%9B%E7%94%9F%E6%8E%A7%E5%88%B6%E7%BA%BF%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n\n[职教高考及高职分类招生控制线](https://www.gugudata.com/api/details/vocationalcontrollines%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E6%95%99%E9%AB%98%E8%80%83%E5%8F%8A%E9%AB%98%E8%81%8C%E5%88%86%E7%B1%BB%E6%8B%9B%E7%94%9F%E6%8E%A7%E5%88%B6%E7%BA%BF%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n* 查询职教高考及高职分类招生控制线\n* 职教高考 / 控制线数据\n* 2999元/年限时折扣 **1499元/年**\n\n[ 查看详情：职教高考及高职分类招生控制线 ](https://www.gugudata.com/api/details/vocationalcontrollines%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E6%95%99%E9%AB%98%E8%80%83%E5%8F%8A%E9%AB%98%E8%81%8C%E5%88%86%E7%B1%BB%E6%8B%9B%E7%94%9F%E6%8E%A7%E5%88%B6%E7%BA%BF%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) 数据校验更新于 3 小时前 \n\n![50% 折扣](https://static.gugudata.com/icon_dis_50.png \"限时 50% 折扣中...\") \n\n[ ![职业与发展心理测评问卷](https://static.gugudata.com/api_psychology_test.png) ](https://www.gugudata.com/api/details/psychology-questionnaires%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E4%B8%9A%E4%B8%8E%E5%8F%91%E5%B1%95%E5%BF%83%E7%90%86%E6%B5%8B%E8%AF%84%E9%97%AE%E5%8D%B7%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n\n[职业与发展心理测评问卷](https://www.gugudata.com/api/details/psychology-questionnaires%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E4%B8%9A%E4%B8%8E%E5%8F%91%E5%B1%95%E5%BF%83%E7%90%86%E6%B5%8B%E8%AF%84%E9%97%AE%E5%8D%B7%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) \n* 专业心理测评与职业发展心理测评\n* 心理测评 / 职业发展\n* 1999元/年限时折扣 **999元/年**\n\n[ 查看详情：职业与发展心理测评问卷 ](https://www.gugudata.com/api/details/psychology-questionnaires%20%22%E6%9F%A5%E7%9C%8B%20%E8%81%8C%E4%B8%9A%E4%B8%8E%E5%8F%91%E5%B1%95%E5%BF%83%E7%90%86%E6%B5%8B%E8%AF%84%E9%97%AE%E5%8D%B7%20%E6%8E%A5%E5%8F%A3%E8%AF%A6%E6%83%85%22) 被调用于 6 秒前 \n\n![50% 折扣](https://static.gugudata.com/icon_dis_50.png \"限时 50% 折扣中...\") \n\n公司\n\n* [关于咕咕数据](https://www.gugudata.com/contact%20%22%E4%BA%86%E8%A7%A3%E5%92%95%E5%92%95%E6%95%B0%E6%8D%AE%E5%85%AC%E5%8F%B8%E4%BF%A1%E6%81%AF%22)\n* [联系我们](https://www.gugudata.com/contact%20%22%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%22)\n\n条款\n\n* [用户协议](https://www.gugudata.com/license%20%22%E6%9F%A5%E7%9C%8B%E7%94%A8%E6%88%B7%E5%8D%8F%E8%AE%AE%22)\n* [免责声明](https://www.gugudata.com/disclaimer%20%22%E6%9F%A5%E7%9C%8B%E5%85%8D%E8%B4%A3%E5%A3%B0%E6%98%8E%22)\n* [数据合规](https://www.gugudata.com/data-compliance%20%22%E6%9F%A5%E7%9C%8B%E6%95%B0%E6%8D%AE%E5%90%88%E8%A7%84%E5%A3%B0%E6%98%8E%22)\n\n商业 API\n\n* [新闻 / 资讯](https://www.gugudata.com/api/news/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%E6%96%B0%E9%97%BB%E8%B5%84%E8%AE%AF%E7%B1%BB%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%22)\n* [金融 / 分析](https://www.gugudata.com/api/finance/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%E9%87%91%E8%9E%8D%E5%88%86%E6%9E%90%E7%B1%BB%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%22)\n* [股票 / 证券](https://www.gugudata.com/api/stock/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%E8%82%A1%E7%A5%A8%E8%AF%81%E5%88%B8%E7%B1%BB%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%22)\n\n更多分类\n\n* [AI / 模型](https://www.gugudata.com/api/ai/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%20AI%20%E6%A8%A1%E5%9E%8B%E7%B1%BB%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%22)\n* [位置 / 坐标](https://www.gugudata.com/api/location/9/0/9/0%20%22%E6%9F%A5%E7%9C%8B%E4%BD%8D%E7%BD%AE%E5%9D%90%E6%A0%87%E7%B1%BB%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%22)\n* [全部数据服务](https://www.gugudata.com/api/all/9/0/9/0/%E4%B8%8D%E9%99%90%20%22%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E6%95%B0%E6%8D%AE%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%22)\n\n文档\n\n* [接口文档](https://doc.gugudata.com/ \"查看接口文档\")\n* [OpenAPI 规范](https://www.gugudata.com/openapi/gugudata.openapi.3.1.json%20%22%E6%9F%A5%E7%9C%8B%20OpenAPI%20%E8%A7%84%E8%8C%83%22)\n* [Swagger 文档](https://www.gugudata.com/swagger%20%22%E6%9F%A5%E7%9C%8B%20Swagger%20%E6%96%87%E6%A1%A3%22)\n\n在线调试\n\n* [Postman](https://www.postman.com/gugudata/gugudata-official/collection/1163860-ee114343-4622-4a54-a39b-994173c27dac/?action=share\u0026creator=1163860\u0026active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35 \"在 Postman 中调试接口\")\n* [Apifox](https://doc.gugudata.com/ \"在 Apifox 中调试接口\")\n\n平台\n\n* [开发者中心](https://www.gugudata.com/signin?returnurl=%2Fportal%2F%20%22%E8%BF%9B%E5%85%A5%E5%BC%80%E5%8F%91%E8%80%85%E4%B8%AD%E5%BF%83%22)\n* [接口状态](https://www.gugudata.com/status%20%22%E6%9F%A5%E7%9C%8B%E6%8E%A5%E5%8F%A3%E5%AE%9E%E6%97%B6%E7%8A%B6%E6%80%81%22)\n* [MCP 服务](https://www.gugudata.com/mcp%20%22%E6%9F%A5%E7%9C%8B%20MCP%20%E6%9C%8D%E5%8A%A1%22)\n\n接入与支持\n\n* [接入示例](https://www.gugudata.com/api/details/stockcnrealtime#anchor%5Fcode%20%22%E6%9F%A5%E7%9C%8B%E6%8E%A5%E5%85%A5%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81%22)\n* [常见问题](https://www.gugudata.com/api/details/stockcnrealtime#anchor%5Fqa%20%22%E6%9F%A5%E7%9C%8B%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94%22)\n* [工程服务](https://engineering.gugudata.com \"工程服务\")\n\nCopyright © 2015-2026[江苏满数数据科技有限公司](https://www.gugudata.com \"访问江苏满数数据科技有限公司官网\"). All rights reserved. [苏ICP备2022035649号](http://beian.miit.gov.cn/ \"查看网站备案信息\") \n\n[ ](https://www.gugudata.com/coupon%20%22%E9%A2%86%E5%8F%96%E4%BC%98%E6%83%A0%E5%88%B8%22) "}