Skip navigation

Reference Manual (API Version 1.9)

O*NET OnLine Services >
https://services.onetcenter.org/v1.9/ws/online/search?keyword=[phrase or code]
JSON XML
{
   "keyword" : "architect",
   "start" : 1,
   "end" : 20,
   "total" : 58,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/search?keyword=architect&start=21&end=40",
         "rel" : "next"
      }
   ],
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/17-1011.00/",
         "relevance_score" : 99,
         "code" : "17-1011.00",
         "title" : "Architects, Except Landscape and Naval",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         }
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/25-1031.00/",
         "relevance_score" : 90,
         "code" : "25-1031.00",
         "title" : "Architecture Teachers, Postsecondary",
         "tags" : {
            "bright_outlook" : false,
            "green" : false
         }
      },
      ...
   ]
}

Interactive demo  •  View at O*NET OnLine

This response searches for O*NET occupations using a word, phrase, or title. The closest matches are returned first.

If the service is called with a full or partial O*NET-SOC code, matching results are returned sorted by code. The relevance_score attribute is not present for code matches. If the given code is only found in a previous O*NET-SOC taxonomy, relevant occupations are returned from the current taxonomy.

The result list is paged, returning 20 occupations at a time by default. To navigate the full set of results, use the link rel="next" and link rel="prev" elements, or provide start and end parameters to jump directly to the desired results.

To learn more about the keyword search, see the following technical report:

In this section