# Timeshighereducation — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Times Higher Education data including global university rankings across dozens of subject areas, detailed university profiles with scoring breakdowns, academic job listings, and site-wide search for articles and university pages.

**Category:** Education | **Website:** [timeshighereducation.com/](https://timeshighereducation.com/) | **Docs:** [parse.bot/marketplace/bbe95fc8-79c4-4373-b895-7b786badfae1/timeshighereducation-com-api](https://parse.bot/marketplace/bbe95fc8-79c4-4373-b895-7b786badfae1/timeshighereducation-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-timeshighereducation-com-api-bbe95fc8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_rankings

Fetch university rankings for a specific type and year. Returns ranked university entries with overall and pillar scores, student statistics, and a URL slug for fetching each university's full profile. Supports filtering by country name. A single request returns all entries for the given ranking type and year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter results by country name, matched case-insensitively against the location field (e.g. United Kingdom, United States, Germany). |
| `ranking_type` | string | No | Ranking type slug. |
| `year` | string | No | Year of rankings (e.g. 2024, 2025). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeshighereducation-com-api-bbe95fc8/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","ranking_type":"<string>","year":"<string>"}'
```

### get_scholarship_guides

Search the Times Higher Education site and return results organized by section (e.g. Universities, Student Articles, Resources). Useful for discovering university listings, news, and editorial content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search keyword for the Times Higher Education site search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeshighereducation-com-api-bbe95fc8/get_scholarship_guides \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_university_profile

Fetch a detailed university profile page including description, key statistics metadata, rankings metadata, and similar university recommendations. The url parameter accepts a slug from the get_rankings endpoint's url field. Returns structured profile data extracted from the page's embedded JSON.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | University URL path or slug (e.g. /world-university-rankings/university-oxford, /world-university-rankings/massachusetts-institute-technology). Typically sourced from get_rankings results[*].url. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeshighereducation-com-api-bbe95fc8/get_university_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_jobs

Fetch academic job listings from Times Higher Education. Returns all current job postings, optionally filtered client-side by keyword and/or location. The available jobs vary over time; filtering may return empty results if no current listings match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Filter by location string or country name (case-insensitive substring match against the job's location and country_name fields). |
| `query` | string | No | Search keyword to filter jobs by title or description (case-insensitive substring match). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeshighereducation-com-api-bbe95fc8/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","query":"<string>"}'
```