Open data, API and MCP server

Everything on CourseToJob is available to people, developers and AI assistants: free downloads, a JSON API, an MCP server, an A2A agent and Markdown versions of every page.

Updated September 26, 2026 How we use data

Datasets

Dataset	Formats	Based on
Graduate outcomes by country Degree premium, earnings by education and unemployment by education for every country with data.	CSV · JSON	ILOSTAT
Countries Headline graduate metrics and names in 12 languages for every country page.	JSON	ILOSTAT, OECD, World Bank
Careers Careers with ISCO-08, SOC and ESCO codes, US median pay and names in 12 languages.	JSON	ESCO, US BLS, ILOSTAT
Degree subjects Subjects with ISCED-F codes and linked careers.	JSON	OECD, UK DfE (LEO)
Data package Frictionless Data Package describing the downloadable datasets.	JSON	Frictionless Data Package

UK graduate earnings by subject and by university (DfE LEO) are also published on our UK edition.

Our compiled datasets are licensed under CC BY 4.0. Please credit “CourseToJob” with a link, and the original source named in each file.

JSON API

The API is free, needs no key and returns JSON with names and text in all 12 languages.

/api/v1/index.json — catalogue of endpoints
/api/v1/careers/{id}.json, /api/v1/subjects/{id}.json, /api/v1/countries/{iso2}.json — full records for one career, subject or country
/api/v1/search?q=…&lang=… — search in any language
/openapi.json — OpenAPI 3.1 · /.well-known/api-catalog (RFC 9727)

curl https://coursetojob.com/api/v1/search?q=nurse&lang=en

MCP server for AI assistants

Connect Claude, ChatGPT, Cursor or any client that supports the Model Context Protocol. The server is read-only, needs no login and answers in 12 languages.

Endpoint: https://coursetojob.com/mcp · server card

search — Full-text search across CourseToJob in any of 12 languages. Returns matching pages with type, id, localized name, URL and Markdown URL. Use it first when you do not know an exact id.
get_career — Career profile: what the job involves, skills, entry routes, degree subjects that lead to it, licensing, progression, FAQs, official US pay (BLS) where published, ILO occupation-group earnings in selected countries and the official ESCO skills profile.
get_subject — What you can do with a degree subject: careers it leads to, topics, skills, how the degree differs between countries, OECD earnings and employment by field of study, and UK graduate earnings (DfE LEO) where published.
get_country — Official data for one country: median monthly earnings by education level and by occupation group (ILO), the degree premium, unemployment by education for adults and young people, OECD relative earnings, World Bank context and official study/visa/job links where available.
compare_countries — Compare 2–8 countries on degree premium, tertiary and overall unemployment, tertiary earnings (PPP$), OECD relative earnings and GDP per capita.
rank_countries — Rank countries by an official metric: degree_premium (tertiary vs all employees' median earnings), tertiary_unemployment, unemployment_gap (tertiary minus all adults), tertiary_earnings_ppp or youth_tertiary_unemployment. Optional World Bank region filter.
list_catalogue — List ids, localized names and URLs so you never have to guess a slug.

Claude Code

claude mcp add --transport http coursetojob https://coursetojob.com/mcp

JSON configuration (most MCP clients)

{
  "mcpServers": {
    "coursetojob": {
      "type": "http",
      "url": "https://coursetojob.com/mcp"
    }
  }
}

Markdown, A2A and discovery

Request any page as Markdown: curl -H "Accept: text/markdown" https://coursetojob.com/careers/nurse/
A2A agent card: /.well-known/agent-card.json
llms.txt by language: en · es · pt · fr · de · it · ar · zh · ja · ko · hi · id · llms-full.txt
Feeds: RSS · sitemap.xml

Please keep automated requests to a reasonable rate and cache responses. Data files update when official sources publish new figures.