Skip navigation

Reference Manual (API Version 1.9)

Matching careers

https://services.onetcenter.org/v1.9/ws/mpp/interestprofiler/careers?answers=[answer string]
JSON XML
{
   "answers" : "553421321134342523523523254115342111351145453111231155343444",
   "start" : 1,
   "end" : 20,
   "total" : 50,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/mpp/interestprofiler/careers?answers=553421321134342523523523254115342111351145453111231155343444&start=21&end=40",
         "rel" : "next"
      }
   ],
   "career" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/mpp/careers/27-2031.00/",
         "fit" : "Best",
         "code" : "27-2031.00",
         "title" : "Bailarines",
         "tags" : {
            "bright_outlook" : true,
            "green" : false,
            "apprenticeship" : false
         }
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/mpp/careers/39-5094.00/",
         "fit" : "Best",
         "code" : "39-5094.00",
         "title" : "Especialistas en Cuidados de la Piel",
         "tags" : {
            "bright_outlook" : true,
            "green" : false,
            "apprenticeship" : true
         }
      },
      ...
   ]
}

This response returns a list of careers matching the given Interest Profiler answers or interest scores; or occupations in a selected interest area. Exactly one of the following parameter sets must be provided when calling the resource:

  • answers=[answer string] — occupations are matched based on the given Interest Profiler answers. The format of the answers parameter is described above.
  • Realistic=[score] &Investigative=[score] &Artistic=[score] &Social=[score] &Enterprising=[score] &Conventional=[score] — careers are matched based on the given interest scores. These scores may be obtained from the Interest Profiler Results service, or from a source such as the paper-and-pencil Interest Profiler.
  • area=[interest area] — careers most relevant to a single interest area are returned. This may be used to suggest careers outside the matches obtained using a full interest profile. The parameter value should be one of: Realistic, Investigative, Artistic, Social, Enterprising or Conventional.

In addition, an optional parameter may be specified:

  • job_zone=[1-5] — if specified, only careers with the given level of job preparation will be returned. Job Zones are groups of careers that need the same level of experience, education, and training. Note that for some interest profiles, matching careers may not be available in all five Job Zones.

When called using Interest Profiler answers or scores, each career will include a fit attribute, indicating the strength of the match:

  • Best — the career's interest profile is a very strong match to the user's interest profile.
  • Great — the career's interest profile is a strong match to the user's interest profile.
  • Good — the career's interest profile is a less strong match to the user's interest profile.

In this section