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.
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.
data.id (string, required): Unique university identifier in Gugudata system
data.universityName (string, required): Official university name
data.region (string, required): Geographic region
data.country (string, required): Country name
data.city (string, required): City location
data.logoUrl (string, required): URL to university logo image
data.rank (string, required): Overall QS world ranking position
data.academicReputationRank (string, required): Academic reputation ranking position
data.academicReputationScore (string, required): Academic reputation score (0-100)
data.citationsPerFacultyRank (string, required): Citations per faculty ranking position
data.citationsPerFacultyScore (string, required): Citations per faculty score (0-100)
data.facultyStudentRatioRank (string, required): Faculty-to-student ratio ranking position
data.facultyStudentRatioScore (string, required): Faculty-to-student ratio score (0-100)
data.employerReputationRank (string, required): Employer reputation ranking position
data.employerReputationScore (string, required): Employer reputation score (0-100)
data.employmentOutcomesRank (string, required): Employment outcomes ranking position
data.employmentOutcomesScore (string, required): Employment outcomes score (0-100)
data.internationalStudentRatioRank (string, required): International student ratio ranking position
data.internationalStudentRatioScore (string, required): International student ratio score (0-100)
data.internationalResearchNetworkRank (string, required): International research network ranking position
data.internationalResearchNetworkScore (string, required): International research network score (0-100)
data.internationalFacultyRatioRank (string, required): International faculty ratio ranking position
data.internationalFacultyRatioScore (string, required): International faculty ratio score (0-100)
data.sustainabilityRank (string, required): Sustainability ranking position
data.sustainabilityScore (string, required): Sustainability score (0-100)
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.
Comprehensive QS World University Rankings dataset.
Quarterly data updates with latest rankings.
Fuzzy search capabilities by university name.
Detailed performance metrics and scoring breakdown.
Paginated response support for large datasets.
Enterprise-grade HTTPS encryption (TLS v1.0-v1.3).
Apple App Transport Security (ATS) compliant.
Global CDN distribution with multi-node deployment.
High-performance API with load-balanced infrastructure.
