timeshighereducation.com APItimeshighereducation.com ↗
Access THE university rankings, detailed university profiles, academic job listings, and site search via 4 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/a250cfd9-0c7d-421b-87a3-80a0d7d392be/get_rankings?year=2025&country=United+States&ranking_type=computer_science' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch university rankings for a specific type and year. Returns an array of university ranking objects with scores, location, and student statistics. Supports filtering by country name.
| Param | Type | Description |
|---|---|---|
| year | string | Year of rankings (e.g. 2024, 2025). |
| country | string | Filter results by country name, matched case-insensitively against the location field (e.g. United Kingdom, United States, Germany). |
| ranking_type | string | Ranking type slug. Accepted values: world_university_rankings, computer_science, arts_and_humanities, engineering, law, life_sciences, medical, physical_sciences, psychology, social_sciences, business_and_economics, education. |
{
"type": "object",
"fields": {
"data": "array of university ranking objects with rank, name, scores, location, and student stats",
"pillars": "object mapping pillar IDs to pillar metadata (label, weight, description)",
"subjects": "object mapping subject IDs to subject names",
"locations": "object mapping country codes to country name and sid"
},
"sample": {
"data": {
"data": [
{
"url": "/world-university-rankings/university-oxford",
"name": "University of Oxford",
"rank": "1",
"location": "United Kingdom",
"rank_order": "10",
"scores_overall": "98.3",
"scores_research": "98.7",
"scores_teaching": "99.2",
"scores_citations": "99.4",
"stats_number_students": "22,095",
"scores_industry_income": "92.4",
"stats_pc_intl_students": "43%",
"stats_female_male_ratio": "51 : 49",
"stats_student_staff_ratio": "10.8",
"scores_international_outlook": "95.5"
}
],
"pillars": {
"7": {
"id": "7",
"type": "all",
"label": "Overall",
"weight": "1",
"machine": "overall",
"description": "The overall score"
}
},
"subjects": {
"3081": "Computer Science"
},
"locations": {
"GBR": {
"sid": "a4zw0000000GnxQAAS",
"name": "United Kingdom"
}
}
},
"status": "success"
}
}About the timeshighereducation.com API
The Times Higher Education API exposes 4 endpoints covering global university rankings across multiple subject disciplines, detailed university profiles, academic job listings, and site-wide content search. The get_rankings endpoint returns per-institution scores, rank positions, pillar weights, and student statistics, optionally filtered by year, country, and ranking type slug such as world_university_rankings or computer_science.
Rankings and University Profiles
The get_rankings endpoint accepts three optional parameters — year, country, and ranking_type — and returns an array of university objects containing rank, name, location, and detailed scores. The response also includes a pillars map (pillar ID to label, weight, and description) and a locations map (country code to country name and sid), giving you the metadata needed to interpret score breakdowns without a separate lookup call. Supported ranking types include world_university_rankings, computer_science, arts_and_humanities, and engineering, among others.
The get_university_profile endpoint takes a URL slug (available from the url field returned by get_rankings) and returns a structured profile: an HTML-formatted description, key_stats metadata with sectionId and institutionId, rankings visualisation metadata, and a similar_universities object containing recommendedCountry and recommendedGlobal arrays for discovering related institutions.
Job Listings and Content Search
The search_jobs endpoint returns all current academic job postings from the Times Higher Education jobs board. Each job object includes title, description, salary, location, country_name, listing_url, posted_date, expiry_date, and recruiter. Optional query and location parameters perform case-insensitive substring filtering client-side. Because the live job pool changes continuously, filtering by niche terms may return zero results depending on current listings.
The get_scholarship_guides endpoint runs a site-wide search and returns results grouped by section (for example, Universities or Student Articles). Each result object carries title, url, summary, and section, making it useful for discovering editorial content, news articles, and university landing pages alongside ranking data.
- Build a university comparison tool that pulls scores and pillar weights from get_rankings for multiple institutions
- Populate a country-filtered league table by passing a country name to get_rankings and rendering the returned rank and score fields
- Generate university profile pages using the HTML description and similar_universities recommendations from get_university_profile
- Aggregate academic job postings by filtering search_jobs on location or keyword to surface relevant roles in a specific field or region
- Track ranking position changes year-over-year by calling get_rankings with different year values and diffing the returned rank fields
- Surface related editorial content alongside ranking data by querying get_scholarship_guides with a university or subject keyword
- Build an academic recruiter dashboard that monitors expiry_date fields from search_jobs to flag soon-to-close postings
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Times Higher Education offer an official developer API?+
What does get_rankings return beyond a simple list of universities?+
pillars map that associates each pillar ID with its label, weight, and description, and a locations map that resolves country codes to names. These metadata objects let you label and weight scores without extra lookups.Are individual university score breakdowns or indicator-level data available?+
get_rankings endpoint returns top-level scores and pillar-level metadata. Granular sub-indicator scores below the pillar level are not currently exposed. You can fork this API on Parse and revise it to add a dedicated sub-indicator endpoint if that depth is needed.How current are the job listings returned by search_jobs?+
posted_date and expiry_date fields to help you assess freshness.