# topuniversities.com API: List QS university rankings > Lists the QS World University Rankings, or a QS subject ranking, for an edition and optionally one country, with each university's displayed rank, location, overall score and the indicator scores published for that table. Unofficial. Not affiliated with or endorsed by topuniversities.com. - Page: https://fous.com/methods/topuniversities.com/list-university-rankings - Method: `topuniversities.com/list_university_rankings`, version 1 - Website: topuniversities.com - Returns: ranking name, edition year, rows of rank, university, city, country, overall score, profile link and indicator scores - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `year` | integer | no | `2026` | Edition year, such as 2026. Omit for the latest edition of the chosen ranking. | | `country` | string | no | `"United Kingdom"` | Country or territory name, such as United States; omit for all countries. Default "". | | `subject` | string | no | `""` | Subject name in plain words, such as Computer Science; omit for the world ranking. Default "". | | `max_results` | integer | no | `7` | Maximum number of ranked universities to return, such as 50. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "year": 2026, "country": "United Kingdom", "subject": "", "max_results": 7 } ``` Its output: ```json { "rows": [ { "city": "London", "rank": "2", "country": "United Kingdom", "university": "Imperial College London", "overall_score": 99.4, "university_url": "https://www.topuniversities.com/universities/imperial-college-london", "academic_reputation": 99.6, "employer_reputation": 100, "employment_outcomes": 95.9, "sustainability_score": 98.3, "citations_per_faculty": 95, "faculty_student_ratio": 99.3, "international_faculty_ratio": 100, "international_student_ratio": 100, "international_research_network": 97.5, "international_student_diversity": 100 }, { "city": "Oxford", "rank": "4", "country": "United Kingdom", "university": "University of Oxford", "overall_score": 97.9, "university_url": "https://www.topuniversities.com/universities/university-oxford", "academic_reputation": 100, "employer_reputation": 100, "employment_outcomes": 100, "sustainability_score": 77.9, "citations_per_faculty": 91, "faculty_student_ratio": 100, "international_faculty_ratio": 98.8, "international_student_ratio": 98.6, "international_research_network": 100, "international_student_diversity": 98.7 }, { "city": "Cambridge", "rank": "6", "country": "United Kingdom", "university": "University of Cambridge", "overall_score": 97.2, "university_url": "https://www.topuniversities.com/universities/university-cambridge", "academic_reputation": 100, "employer_reputation": 100, "employment_outcomes": 100, "sustainability_score": 78.4, "citations_per_faculty": 88.6, "faculty_student_ratio": 100, "international_faculty_ratio": 100, "international_student_ratio": 93.1, "international_research_network": 99.2, "international_student_diversity": 93.6 } ], "year": 2026, "ranking_name": "QS World University Rankings" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"topuniversities.com/list_university_rankings","input":{"year":2026,"country":"United Kingdom","subject":"","max_results":7}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Show me the top 20 universities in the latest QS World University Rankings with their overall scores - Which German universities made the QS 2025 world rankings? List up to 40 with rank, city and indicator scores - Pull the QS subject ranking for Computer Science, 2024 edition, top 100 worldwide - On topuniversities.com, get the Mechanical Engineering subject table for Canada — I want each school's rank and overall score - I need the top 10 Australian institutions from topuniversities.com's 2026 global table, including academic reputation and employer reputation scores ## Input schema ```json { "type": "object", "properties": { "year": { "type": "integer", "maximum": 2100, "minimum": 2000, "description": "Edition year, such as 2026. Omit for the latest edition of the chosen ranking." }, "country": { "type": "string", "default": "", "description": "Country or territory name, such as United States; omit for all countries." }, "subject": { "type": "string", "default": "", "description": "Subject name in plain words, such as Computer Science; omit for the world ranking." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Maximum number of ranked universities to return, such as 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "ranking_name", "year", "rows" ], "properties": { "rows": { "type": "array", "items": { "type": "object", "required": [ "rank", "university", "city", "country", "overall_score", "university_url" ], "properties": { "city": { "type": [ "string", "null" ] }, "rank": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "university": { "type": "string" }, "overall_score": { "type": [ "number", "null" ] }, "university_url": { "type": "string" } }, "additionalProperties": { "type": [ "number", "null" ] } }, "description": "Universities in QS rank order; additional numeric fields are the indicator scores published for this table." }, "year": { "type": "integer", "description": "Edition year." }, "ranking_name": { "type": "string", "description": "Name of the chosen QS ranking." } } } ``` ## See more - [topuniversities.com API: Get QS university profile](https://fous.com/methods/topuniversities.com/get-university.md): Finds a university's QS profile by name and returns its latest QS World University Ranking and overall score, location, student figures, faculty ratio, public tuition ranges and up to five listed subject ranks. - [Times Higher Education API: List THE World University Rankings](https://fous.com/methods/timeshighereducation.com/list-university-rankings.md): Lists THE World University Rankings for a year, optionally filtered by country, with displayed ranks, scores, student figures and university links. Subject rankings are supported by name. - [Times Higher Education API: Get university profile](https://fous.com/methods/timeshighereducation.com/get-university.md): Looks up a university on Times Higher Education and returns its latest displayed world ranking, overall and pillar scores, student statistics and subject rankings. - [IMF API: List country rankings](https://fous.com/methods/imf.org/list-country-rankings.md): Ranks countries by a World Economic Outlook indicator for a chosen year, excluding regional and group totals and countries without a value. - [Similarweb API: List top websites](https://fous.com/methods/similarweb.com/list-top-websites.md): Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings. - [World Bank API: Compare countries by a statistic](https://fous.com/methods/worldbank.org/compare-countries.md): Ranks countries by a World Development Indicators statistic for a given year, or for the latest year with broad country coverage. Regional aggregates and countries without data for that year are left out. - [Forbes API: List Forbes Global 2000 companies](https://fous.com/methods/forbes.com/list-global-2000.md): Lists companies in the Forbes Global 2000 in rank order, optionally for a given year, country of headquarters and industry. Financial figures are in billions of US dollars; up to 500 results. - [Trading Economics API: List countries by indicator](https://fous.com/methods/tradingeconomics.com/list-countries-by-indicator.md): Compares the latest reported value of an economic indicator across countries in a region, highest first. World includes all listed countries; Australia uses the Oceania region. - [All topuniversities.com methods](https://fous.com/methods/topuniversities.com.md)