# Times Higher Education API: List THE World University Rankings > 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. Unofficial. Not affiliated with or endorsed by Times Higher Education. - Page: https://fous.com/methods/timeshighereducation.com/list-university-rankings - Method: `timeshighereducation.com/list_university_rankings`, version 1 - Website: timeshighereducation.com - Returns: rank, university, country, scores, student figures, university link - 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 | | Ranking year, such as 2025. Defaults to the latest available year. | | `country` | string | no | `"United States"` | Country name as shown by THE, such as United Kingdom. Defaults to all countries. Default "". | | `subject` | string | no | | Subject ranking name, such as Engineering. Defaults to the overall World University Rankings. Default "". | | `max_results` | integer | no | `200` | Maximum universities to return, such as 50; at most 200. Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "country": "United States", "max_results": 200 } ``` Its output: ```json { "year": 2027, "rankings": [ { "rank": "2", "country": "United States", "university": "Massachusetts Institute of Technology", "overall_score": "97.8", "industry_score": "100.0", "research_score": null, "teaching_score": "99.1", "citations_score": null, "university_link": "https://www.timeshighereducation.com/world-university-rankings/massachusetts-institute-technology", "number_of_students": null, "students_per_staff": null, "industry_income_score": null, "research_quality_score": "99.4", "research_environment_score": "96.5", "international_outlook_score": "90.9", "international_students_percent": null }, { "rank": "=3", "country": "United States", "university": "Princeton University", "overall_score": "97.0", "industry_score": "97.2", "research_score": null, "teaching_score": "97.4", "citations_score": null, "university_link": "https://www.timeshighereducation.com/world-university-rankings/princeton-university", "number_of_students": null, "students_per_staff": null, "industry_income_score": null, "research_quality_score": "98.4", "research_environment_score": "98.1", "international_outlook_score": "85.3", "international_students_percent": null }, { "rank": "=3", "country": "United States", "university": "Stanford University", "overall_score": "97.0", "industry_score": "100.0", "research_score": null, "teaching_score": "96.4", "citations_score": null, "university_link": "https://www.timeshighereducation.com/world-university-rankings/stanford-university", "number_of_students": null, "students_per_staff": null, "industry_income_score": null, "research_quality_score": "99.3", "research_environment_score": "98.3", "international_outlook_score": "83.4", "international_students_percent": null } ], "ranking_name": "World University Rankings 2027" } ``` ## 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":"timeshighereducation.com/list_university_rankings","input":{"country":"United States","max_results":200}}' ``` 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 2024 World University Rankings - Which universities in the United Kingdom made the Times Higher Education list for 2025? - I need the Engineering subject ranking from THE for the latest year, top 50 only - List the world university rankings from timeshighereducation.com for 2023 filtered to Germany - What are the scores and student numbers for the top 100 universities in the 2022 THE rankings? ## Input schema ```json { "type": "object", "required": [], "properties": { "year": { "type": "integer", "minimum": 2011, "description": "Ranking year, such as 2025. Defaults to the latest available year." }, "country": { "type": "string", "default": "", "description": "Country name as shown by THE, such as United Kingdom. Defaults to all countries." }, "subject": { "type": "string", "default": "", "description": "Subject ranking name, such as Engineering. Defaults to the overall World University Rankings." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Maximum universities to return, such as 50; at most 200." } } } ``` ## Output schema ```json { "type": "object", "required": [ "ranking_name", "year", "rankings" ], "properties": { "year": { "type": "integer", "description": "Year of the ranking." }, "rankings": { "type": "array", "items": { "type": "object", "required": [ "rank", "university", "country", "overall_score", "teaching_score", "research_environment_score", "research_quality_score", "industry_score", "international_outlook_score", "research_score", "citations_score", "industry_income_score", "number_of_students", "students_per_staff", "international_students_percent", "university_link" ], "properties": { "rank": { "type": [ "string", "null" ], "description": "Rank as displayed, including ties and ranges." }, "country": { "type": [ "string", "null" ], "description": "Country or territory shown by THE." }, "university": { "type": [ "string", "null" ], "description": "University name." }, "overall_score": { "type": [ "string", "null" ], "description": "Overall score as displayed, including ranges or n/a." }, "industry_score": { "type": [ "string", "null" ], "description": "Industry score, if this pillar appears." }, "research_score": { "type": [ "string", "null" ], "description": "Research score, for editions using that name." }, "teaching_score": { "type": [ "string", "null" ], "description": "Teaching score, if this pillar appears in the chosen year." }, "citations_score": { "type": [ "string", "null" ], "description": "Citations score, for editions using that name." }, "university_link": { "type": [ "string", "null" ], "description": "University page on THE." }, "number_of_students": { "type": [ "integer", "null" ], "description": "Number of students when shown." }, "students_per_staff": { "type": [ "number", "null" ], "description": "Students per staff member when shown." }, "industry_income_score": { "type": [ "string", "null" ], "description": "Industry Income score, for editions using that name." }, "research_quality_score": { "type": [ "string", "null" ], "description": "Research Quality score, if this pillar appears." }, "research_environment_score": { "type": [ "string", "null" ], "description": "Research Environment score, if this pillar appears." }, "international_outlook_score": { "type": [ "string", "null" ], "description": "International Outlook score, if this pillar appears." }, "international_students_percent": { "type": [ "number", "null" ], "description": "Percent of international students, on a 0 to 100 scale." } } }, "description": "Universities in the order shown by THE after filtering." }, "ranking_name": { "type": [ "string", "null" ], "description": "Name of this THE ranking edition." } } } ``` ## See more - [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. - [topuniversities.com API: List QS university rankings](https://fous.com/methods/topuniversities.com/list-university-rankings.md): 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. - [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. - [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. - [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. - [WEBTOON API: List rankings](https://fous.com/methods/webtoons.com/list-rankings.md): Lists popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30. - [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members. - [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. - [All Times Higher Education methods](https://fous.com/methods/timeshighereducation.com.md)