Topuniversities APItopuniversities.com ↗
Access QS World University Rankings data to compare universities by overall performance, subject-specific disciplines, and geographic location across multiple years. View detailed university profiles with per-indicator scores to make informed decisions about educational institutions.
curl -X GET 'https://api.parse.bot/scraper/9edae581-c058-4a50-bf4c-ba847862c367/get_world_rankings?items_per_page=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns one page of the QS World University Rankings table for an edition year (latest edition when year is omitted). Each row carries the displayed rank (may be tied, e.g. '=2', or banded, e.g. '801+'), a numeric rank_sort when the rank is a plain integer, overall score, country/region/city, the profile slug, and every indicator score/rank grouped by lens (Research & Discovery, Employability, etc.). Filters (region, country_code, city, search) and sorting are applied by the site. Pagination is 0-based via page and items_per_page (max 100); total_universities, total_pages and has_more come from the site. Two round trips per call.
| Param | Type | Description |
|---|---|---|
| city | string | City name from list_locations.regions[*].countries[*].cities. Omitted = all cities. |
| page | string | 0-based page index. |
| year | string | 4-digit edition year, e.g. 2026. Omitted = latest edition; available editions are listed by list_locations.edition_years. |
| region | string | Region name exactly as returned by list_locations.regions[*].region (e.g. Asia). Omitted = all regions. |
| search | string | Free-text university name search applied by the site. |
| sort_by | string | Sort key: rank, university, overallscore, or indicator_<indicator_id> using an indicator_id from universities[*].indicators. Omitted = rank order. |
| order_by | string | asc or desc; only meaningful with sort_by. |
| country_code | string | Two-letter country code from list_locations.regions[*].countries[*].country_code (e.g. gb). Omitted = all countries. |
| items_per_page | string | Rows per page; values above 100 are clamped to 100. |
{
"type": "object",
"fields": {
"page": "integer 0-based page returned",
"has_more": "boolean, true when a later page exists",
"total_pages": "integer",
"edition_year": "edition year parsed from the ranking title",
"universities": "array of ranked rows: rank, rank_sort, university_id, core_id, name, slug (for get_university_profile), profile_url, region, country, city, logo, overall_score, stars, indicators[] {group, indicator_id, indicator_name, rank, score}",
"ranking_title": "page title of the ranking edition",
"items_per_page": "integer page size honoured by the site",
"total_universities": "integer total rows matching the filters"
},
"sample": {
"data": {
"page": 1,
"has_more": true,
"total_pages": 19,
"edition_year": "2027",
"universities": [
{
"city": "London",
"logo": "https://www.topuniversities.com/sites/default/files/231024034600pm558869KCL-box-red-485-rgb-90x90.jpg",
"name": "King's College London",
"rank": "37",
"slug": "kings-college-london",
"stars": "",
"region": "Europe",
"core_id": "357",
"country": "United Kingdom",
"rank_sort": 37,
"indicators": [
{
"rank": "44",
"group": "Research & Discovery",
"score": "96.3",
"indicator_id": "76",
"indicator_name": "Academic Reputation"
}
],
"profile_url": "https://www.topuniversities.com/universities/kings-college-london",
"overall_score": "85.7",
"university_id": "294029"
}
],
"ranking_title": "QS World University Rankings 2027: Top Global Universities | TopUniversities",
"items_per_page": 5,
"total_universities": 93
},
"status": "success"
}
}About the Topuniversities API
The Topuniversities API on Parse exposes 5 endpoints for the publicly available data on topuniversities.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.