Occupation Matcher

Given at least one of: job title, job description, or related skills, returns a list of best-matched occupations from Pearson’s Occupation Ontology, including occupation stream, level, and associated skills. Results are ranked by relevance.

Skills returned might vary depending on the {country_code}(default: US) provided.

This API uses large language models (LLMs) to enhance reasoning, contextual understanding, and ambiguity handling, making it well suited for complex, unclear, or messy inputs where match quality is critical.

If you prefer not to send data to LLMs, please use the Occupation Matcher (Non-Generative) instead.
ap-southeast-2 ca-central-1 eu-central-1 eu-west-2 ap-southeast-1 us-east-2

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request model for occupation matcher API.

string

Approximate occupation title you want to match

string

Description of the occupation you want to match

skill_names
array of strings
Defaults to []

Optional list of skill names relevant to provided title. Used to narrow down recommendations.

Skill Names
string
^[A-Z]{2}$
Defaults to US

Skills data for this country will be used to generate response. ISO 3166-1 alpha-2.

integer
Defaults to 5

The number of results to be returned. Maximum of 5.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json