
Global QS World University Rankings
Search QS World University Rankings with filters and pagination
Explore global university profiles, rankings, and student data
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Use this lookup capability to turn a user or system input into structured data your product can consume directly.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
The Global University Data response exposes this data in a documented format for storage, display, validation, and downstream processing.
Use this integration capability when exposing results to production applications, internal tools, or customer-facing workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.
Use this integration capability when exposing results to production applications, internal tools, or customer-facing workflows.
This Global University Data feature is available through the documented endpoint and can be used in application, automation, or data workflows.

HTTP Protocol:HTTPS
HTTP Method:GET
HTTP Endpoint:https://api.gugudata.io/v1/metadata/global-university
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/metadata/global-university/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type. |
| name | string | false | Name filter used by the endpoint dataset. | |
| country | string | false | Country filter used by the endpoint dataset. | |
| region | string | false | Region filter used by the endpoint dataset. | |
| city | string | false | City filter used by the endpoint dataset. | |
| sort | string | false | rank|asc | Sort expression in `field|direction` format, for example `rank|asc`. |
| pageIndex | integer | false | 1 | One-based page index for pagination. |
| pageSize | integer | false | 10 | Number of records returned per page. |
| Name | Type | Remark |
|---|---|---|
| dataStatus | object | Response metadata returned by the current v1 contract. |
| dataStatus.requestParameter | string | Normalized request parameters echoed by the service. |
| dataStatus.statusCode | integer | Application-level status code returned by the current v1 contract. |
| dataStatus.status | string | Application-level status enum returned by the current v1 contract. |
| dataStatus.statusDescription | string | Application-level status message returned by the current v1 contract. |
| dataStatus.responseDateTime | string | Response timestamp returned by the current service contract. |
| dataStatus.dataTotalCount | integer | Total number of records that match the request. |
| data | object | University records returned by the endpoint. |
| data[].rank | integer | QS World University Ranking position. |
| data[].website | string | University official website URL. |
| data[].universityName | string | Official university name. |
| data[].universityChineseName | string | Chinese university name when available. |
| data[].logo | string | University logo image URL. |
| data[].region | string | Geographic region. |
| data[].country | string | Country name. |
| data[].city | string | City location. |
| data[].internationalStudents | integer | Number of international students enrolled. |
| data[].subjectCount | integer | Number of academic subjects offered. |
| data[].programmeCount | integer | Number of academic programme records linked to the university. |
| data[].programmeDataAvailable | boolean | Whether programme records are available for this university. |
| data[].programmes | object | Sample academic programme records linked to the university. |
| data[].programmes[].programmeId | string | Public programme identifier. |
| data[].programmes[].programmeName | string | Academic programme name. |
| data[].programmes[].studyLevel | string | Study level, such as Undergraduate or Postgraduate. |
| data[].schoolUUID | string | Public university identifier for Gugudata API correlation. |
| data[].institutionType | string | University institution type when available. |
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | Request processed successfully. | Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`. |
| 400 | Invalid request parameters or request format. | Check required fields, data types, and request body format. |
| 401 | Missing or unknown application key. | Provide a valid `appkey` with the request. |
| 403 | The application key is recognized but access is not allowed. | The key may be expired, inactive, or not permitted for the requested API. |
| 429 | Request rate or trial usage limit exceeded. | Reduce concurrency or retry after the limit window resets. |
| 500 | Internal service error. | Retry later or contact support if the error persists. |
| 503 | Upstream service unavailable. | Retry later; the requested upstream dependency is temporarily unavailable. |
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
https://mcp.gugudata.io/mcp{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}
Search QS World University Rankings with filters and pagination

Search standardized US college and university data

Search US college programs, credentials, costs, and outcomes

Search nearly 400,000 works of classical Chinese poetry