# Global University Data
Search university profiles, rankings, and programme data worldwide.
## API Overview
- **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:** https://gugudata.io/demo/global-university
- **Postman:** https://www.postman.com/gugudata/gugudata-io
- **LLM Page:** https://gugudata.io/details/global-university/llm
- **Raw Markdown:** https://gugudata.io/details/global-university/llm.md
## Remote MCP
- **MCP Endpoint:** https://mcp.gugudata.io/mcp
- **MCP Guide:** https://gugudata.io/mcp/
- **Authorization:** OAuth authorization opens in the browser; do not paste appkeys into MCP clients.
- **Tool Scope:** MCP clients receive GuGuData API tools available to the authorized account.
## Data & API Features
- Worldwide university search: Find universities by name across a structured international dataset.
- Location filters: Narrow results by country, region, or city.
- Institution and ranking data: Review available ranking, website, location, and institution fields.
- Programme discovery: Read linked programme availability and sample programme records when provided.
- Sorting and pagination: Build stable result pages with explicit sorting and matching totals.
- Education applications: Power university discovery, comparison, research, and advising workflows.
## API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
| --- | --- | --- | --- | --- |
| appkey | string | true | YOUR_APPKEY | API key used to authenticate the request. |
| name | string | false | | Optional university name used to filter the dataset. |
| country | string | false | | Optional country name used to filter results. |
| region | string | false | | Optional geographic region used to filter results. |
| city | string | false | | Optional city name used to filter results. |
| 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. |
## API Response Parameters
| Name | Type | Remark |
| --- | --- | --- |
| dataStatus | object | Response metadata returned by the current v1 contract. |
| dataStatus.requestParameter | string | Privacy-safe summary of the normalized request. |
| dataStatus.statusCode | integer | Application-level status code. |
| dataStatus.status | string | Application-level result status. |
| dataStatus.statusDescription | string | Human-readable application status message. |
| dataStatus.responseDateTime | string | Time at which the response was generated. |
| dataStatus.dataTotalCount | integer | Number of matching or returned records for this 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. |
## API Response Status Codes
| 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 request frequency and retry with backoff. If a trial allowance is exhausted, check Trial Keys for remaining requests and subscribe to continue. |
| 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. |
## cURL Example
```bash
curl --location 'https://api.gugudata.io/v1/metadata/global-university?appkey=YOUR_APPKEY&name=YOUR_VALUE&country=YOUR_VALUE®ion=YOUR_VALUE&city=YOUR_VALUE&sort=rank%7Casc&pageIndex=1&pageSize=10'
```