# StudyPortals Study Programmes API

> StudyPortals: 250,000 bachelor, master and PhD programmes with fees, duration and universities

- Vendor: `studyportalsstudyprogrammesapi` · version 1.0 · category Education · tags studyportals api, study programmes api, university courses api, masters programs api, phd programs api, tuition fees api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/studyportalsstudyprogrammesapi
- This document: https://apiclay.com/docs/studyportalsstudyprogrammesapi.md
- OpenAPI 3.1: https://apiclay.com/api/studyportalsstudyprogrammesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `studyportalsstudyprogrammesapi`
- Updated: 2026-11-18

## About

## StudyPortals Study Programmes API

The programme search behind StudyPortals (Bachelorsportal, Mastersportal, PhDportal): about 250,000 university programmes worldwide, searchable by keyword, discipline, degree type and attendance, each with title, level, degree, summary, university, location and country, tuition fees, duration, timing, study mode (online, on campus, blended, full or part time), living costs, English requirements, GPA, ECTS and review rating; plus the currency rates StudyPortals uses to convert fees.

Data comes from **phdportal.com** (https://www.phdportal.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/programmes?text=data science&amp;resultSize=10&amp;resultOffset=0`, narrow with `degreeTypes=msc` or `disciplines=24`, page with `resultOffset`.

### Routes

#### GET `/programmes` - Programmes
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| resultSize | query | number | yes | Programmes per page, e.g. 10. |
| resultOffset | query | number | yes | Programmes to skip, for paging (0 first). |
| text | query | string | no | Keyword search, e.g. `data science`. |
| degreeTypes | query | string | no | Degree abbreviation, e.g. `msc`, `ma`, `mba`, `phd`, `bsc`. |
| disciplines | query | number | no | StudyPortals discipline id, e.g. `24` (Computer Science); see `getDisciplineIds` on results. |
| attendances | query | string | no | `online`, `on_campus` or `blended`. |

Returns: `hitsTotal` and `programmes` array; each `card.func` has `getId`, `getTitle`, `getLevel`, `getDegree`, `getSummary`, `getProgrammeLink`, `getUniversityLink`, `getLocation`, `getCountryIsoCode`, `getTuitionFees`, `getDuration`, `getTimings`, `isOnline`, `isOnCampus`, `isFullTime`, `getLivingCost`, `getEnglishRequirements`, `getGPA`, `getEcts`, `getDisciplineIds`, `getReviewRating`, `getLastUpdated`.

#### GET `/currency-rates` - Currency rates
No parameters.

Returns: `document.source` (`EUR`) and `document.currencies` keyed by code with `name` and `quote` per euro, plus `updated_at` and `next_update` (ms epoch).

### Caveats

- Programme facts come from the universities via StudyPortals and can lag the university's own pages; check fees and deadlines on the programme link before applying.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by phdportal.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /programmes — Programmes
- Gateway: `GET https://api.apiclay.com/v1/api/studyportalsstudyprogrammesapi/programmes`
- Public query params: `resultSize` (number, required), `resultOffset` (number, required), `text` (string), `degreeTypes` (string), `disciplines` (string), `attendances` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /currency-rates — Currency rates
- Gateway: `GET https://api.apiclay.com/v1/api/studyportalsstudyprogrammesapi/currency-rates`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/studyportalsstudyprogrammesapi/programmes?resultSize=<resultSize>&resultOffset=<resultOffset>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
