appkey (string, required): 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, optional): Name filter used by the endpoint dataset.
country (string, optional): Country filter used by the endpoint dataset.
region (string, optional): Region filter used by the endpoint dataset.
city (string, optional): City filter used by the endpoint dataset.
sort (string, optional): Sort expression in field|direction format, for example rank|asc.
pageIndex (integer, optional): One-based page index for pagination.
pageSize (integer, optional): Number of records returned per page.
dataStatus (object, required): Response metadata returned by the current v1 contract.
dataStatus.requestParameter (string, required): Normalized request parameters echoed by the service. Sensitive credentials are omitted when available.
dataStatus.statusCode (integer, required): Application-level status code returned by the current v1 contract.
dataStatus.status (string, required): Application-level status enum returned by the current v1 contract.
dataStatus.statusDescription (string, required): Application-level status message returned by the current v1 contract.
dataStatus.responseDateTime (string, required): Response timestamp returned by the current service contract.
dataStatus.dataTotalCount (integer, required): Total number of records that match the request.
data (object, required): Primary response payload returned by the endpoint.
DataStatus.RequestParameter (string, required): Normalized request parameters echoed by the service. Sensitive credentials are omitted when available.
DataStatus.StatusCode (integer, required): Application-level status code returned by the current v1 contract.
DataStatus.StatusDescription (string, required): Application-level status message returned by the current v1 contract.
DataStatus.ResponseDateTime (string, required): Response timestamp returned by the current service contract.
DataStatus.DataTotalCount (integer, required): Total number of records that match the request.
Data.rank (integer, required): QS World University Ranking position
Data.website (string, required): University official website URL
Data.universityName (string, required): Official university name
Data.logo (string, required): URL to university logo image
Data.region (string, required): Geographic region
Data.country (string, required): Country name
Data.city (string, required): City location
Data.internationalStudents (integer, required): Number of international students enrolled
Data.subjectCount (integer, required): Number of academic subjects offered
Data.schoolUUID (string, required): Unique university identifier in Gugudata system for data correlation
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.
100 Request successful: No additional remark.
101 Invalid request parameters: No additional remark.
102 Rate limit exceeded: Maximum 100 requests per second allowed
103 Account payment overdue: No additional remark.
104 Invalid API key: Please verify your API key from the developer console
110 Internal server error: No additional remark.
Nearly 7,000 world universities with latest basic data.
Detailed ranking information for top global universities.
Manual data updates every half month.
Comprehensive university information including basic details, geographic location, and official websites.
Multi-dimensional filtering by country, region, and city.
Fuzzy search and multi-field sorting capabilities.
Fully compatible with other university APIs on Gugudata platform.
Millisecond-level response performance.
Full HTTPS support (TLS v1.0 / v1.1 / v1.2 / v1.3).
Apple App Transport Security (ATS) compliant.
Global CDN distribution with multi-node deployment.
High-performance API with load-balanced infrastructure.
