Bestseller
Global Rankings Higher Education

Global QS World University Rankings

Search QS World University Rankings with filters and pagination

What can this API do?

QS ranking search

Search ranked universities by name through a structured API.

Ranking indicators

Review available overall ranks and published indicator scores.

University profiles

Receive institution, country, city, region, and logo fields when available.

Stable pagination

Browse large result sets using predictable page controls and totals.

Nullable source values

Handle unavailable ranking fields explicitly instead of treating them as zero.

Education research

Build ranking comparisons, discovery tools, and higher-education research workflows.

Global QS World University Rankings
Annual plan
$49$99
Subscribe Annually Try Demo Request
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:GET

HTTP Endpoint:https://api.gugudata.io/v1/metadata/qs-global-university-ranking

Response Type:application/json; charset=utf-8

DEMO Endpoint:https://api.gugudata.io/v1/metadata/global-university-ranking/demo

Live Demo:Try Interactive Demo

Postman Collection:Run in Postman

API Request Parameters

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEY API key used to authenticate the request.
namestringfalse Optional university name used for case-insensitive partial matching.
pageIndexintegerfalse1 One-based page number. Defaults to the first page.
pageSizeintegerfalse10 Number of university records to return per page.

API Response Parameters

NameTypeRemark
dataStatusobject Response metadata returned by the current v1 contract.
dataStatus.requestParameterstring Privacy-safe summary of the normalized request.
dataStatus.statusCodeinteger Application-level status code.
dataStatus.statusstring Application-level result status.
dataStatus.statusDescriptionstring Human-readable application status message.
dataStatus.responseDateTimestring Time at which the response was generated.
dataStatus.dataTotalCountinteger Number of matching or returned records for this request.
dataobject Primary response payload returned by the endpoint.
data.idstring Unique university identifier in Gugudata system.
data.universityNamestring Official university name.
data.regionstring Geographic region.
data.countrystring Country name.
data.citystring City location.
data.logoUrlstring URL to university logo image.
data.rankstring Overall QS world ranking position.
data.academicReputationRankstring Academic reputation ranking position.
data.academicReputationScorestring Academic reputation score (0-100).
data.citationsPerFacultyRankstring Citations per faculty ranking position.
data.citationsPerFacultyScorestring Citations per faculty score (0-100).
data.facultyStudentRatioRankstring Faculty-to-student ratio ranking position.
data.facultyStudentRatioScorestring Faculty-to-student ratio score (0-100).
data.employerReputationRankstring Employer reputation ranking position.
data.employerReputationScorestring Employer reputation score (0-100).
data.employmentOutcomesRankstring Employment outcomes ranking position.
data.employmentOutcomesScorestring Employment outcomes score (0-100).
data.internationalStudentRatioRankstring International student ratio ranking position.
data.internationalStudentRatioScorestring International student ratio score (0-100).
data.internationalResearchNetworkRankstring International research network ranking position.
data.internationalResearchNetworkScorestring International research network score (0-100).
data.internationalFacultyRatioRankstring International faculty ratio ranking position.
data.internationalFacultyRatioScorestring International faculty ratio score (0-100).
data.sustainabilityRankstring Sustainability ranking position.
data.sustainabilityScorestring Sustainability score (0-100).

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
503Upstream service unavailable.Retry later; the requested upstream dependency is temporarily unavailable.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

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.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets

Run in Postman Open LLM Page

Related APIs

Useful APIs to extend this workflow.

View all APIs