API WORKFLOWS

University and Education Data APIs

Use institution profiles for university discovery and ranking records for comparison views. Global University provides broader profile fields; QS Rankings offers a focused ranking dataset. Keep ranking editions and data coverage visible in your application.

Browse APIs Integration help

A practical integration workflow

Choose profile data or ranking records for the question your application answers.
Apply documented name or location filters and paginate the results.
Handle missing fields and verify dataset coverage before presenting comparisons.

Choose an API and try an example

Each example uses the normal API endpoint. Replace YOUR_APPKEY with your own key. Use the separate Demo link to view fixed sample data without a subscription.

Global University Data

Filter university profiles and paginate results for discovery or research applications.

Input and coverage: Use one-based pageIndex; pageSize is capped at 20. Ranking and programme fields are dataset-specific, and not every institution has programme data.

Example request

Replace YOUR_APPKEY with your own API key. This request uses the normal API endpoint.

curl --fail-with-body 'https://api.gugudata.io/v1/metadata/global-university?appkey=YOUR_APPKEY&name=Massachusetts&sort=rank%7Casc&pageIndex=1&pageSize=5'

View sample Demo response

This is a fixed Demo sample, shortened for readability. It is not the response to your example request. Your results depend on the input and dataset. File URLs are temporary and have been removed.

{
  "dataStatus": {
    "statusCode": 100,
    "status": "SUCCESS",
    "statusDescription": "请求成功。",
    "dataTotalCount": 7536
  },
  "data": [
    {
      "rank": 1,
      "website": "http://web.mit.edu",
      "universityName": "Massachusetts Institute of Technology (MIT)",
      "universityChineseName": "麻省理工学院",
      "logo": "https://api.gugudata.io/v1/metadata/global-university-logo/1b9c4add-2664-415c-909c-a3a5c22b2d60.jpg",
      "region": "North America",
      "country": "United States",
      "city": "Cambridge",
      "internationalStudents": 3798,
      "subjectCount": 19,
      "programmeCount": 0,
      "programmeDataAvailable": false,
      "programmes": [],
      "institutionType": ""
    }
  ]
}

API documentation Try Demo

QS World University Rankings

Search university ranking records by name and build paginated result views.

Input and coverage: Use one-based pageIndex; pageSize is capped at 20. Confirm the dataset edition and coverage before using ranks for comparisons.

Example request

Replace YOUR_APPKEY with your own API key. This request uses the normal API endpoint.

curl --fail-with-body 'https://api.gugudata.io/v1/metadata/qs-global-university-ranking?appkey=YOUR_APPKEY&name=Massachusetts&pageIndex=1&pageSize=5'

View sample Demo response

This is a fixed Demo sample, shortened for readability. It is not the response to your example request. Your results depend on the input and dataset. File URLs are temporary and have been removed.

{
  "dataStatus": {
    "statusCode": 100,
    "status": "SUCCESS",
    "statusDescription": "请求成功。",
    "dataTotalCount": 1503
  },
  "data": [
    {
      "id": "ed333a3b-d3e9-433a-8d8a-2afff9bd78f5",
      "universityName": "Massachusetts Institute of Technology (MIT)",
      "region": "North America",
      "country": "United States",
      "city": "Cambridge",
      "logoUrl": "https://api.gugudata.io/v1/metadata/global-university-logo/ed333a3b-d3e9-433a-8d8a-2afff9bd78f5.jpg",
      "rank": "1",
      "academicReputationRank": "4",
      "academicReputationScore": "100",
      "citationsPerFacultyRank": "9",
      "citationsPerFacultyScore": "100",
      "facultyStudentRatioRank": "11",
      "facultyStudentRatioScore": "100",
      "employerReputationRank": "2",
      "employerReputationScore": "100",
      "employmentOutcomesRank": "8",
      "employmentOutcomesScore": "100",
      "internationalStudentRatioRank": "143",
      "internationalStudentRatioScore": "86.8",
      "internationalResearchNetworkRank": "58",
      "internationalResearchNetworkScore": "96",
      "internationalFacultyRatioRank": "100",
      "internationalFacultyRatioScore": "99.3",
      "sustainabilityRank": "15",
      "sustainabilityScore": "99"
    }
  ]
}

API documentation Try Demo

Limits and things to check

Ranking position is not a measure of fit for an individual student. Programme coverage varies across institutions. These endpoints are not live admissions, tuition, or application eligibility services.

Normal paid API subscriptions include unlimited total requests during the active paid term, with up to 5 requests per second. Free trials have a limited allowance: sign in and check Trial Keys for the balance. Read each product page for pricing, renewal, and cancellation details.