Skip navigation

Reference Manual

Notice: the Web Services API will be upgraded on March 5, 2019. See the API Version 1.9 page for more information.

O*NET OnLine Services >
https://services.onetcenter.org/ws/online/search?keyword=[phrase or code]
JSON XML
{
   "keyword" : "architect",
   "start" : 1,
   "end" : 20,
   "total" : 68,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/search?keyword=architect&start=21&end=40",
         "rel" : "next"
      }
   ],
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/occupations/17-1011.00/",
         "relevance_score" : 100,
         "code" : "17-1011.00",
         "title" : "Architects, Except Landscape and Naval",
         "tags" : {
            "bright_outlook" : false,
            "green" : true
         }
      },
      {
         "href" : "https://services.onetcenter.org/ws/online/occupations/17-3011.01/",
         "relevance_score" : 91,
         "code" : "17-3011.01",
         "title" : "Architectural Drafters",
         "tags" : {
            "bright_outlook" : false,
            "green" : true
         }
      },
      ...
   ]
}

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.

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