JO Job Outlook API reference

API reference

Job Outlook

This application is a simple API that returns the job outlook for a given program. This page and the links below are displays of the data for the browser.

Request

The endpoint for this application is below. cip is required (110101 and 11.0101 are both valid). institution is optional and defaults to kctcs. Passing an institution other than kctcs returns the stats for the region the institution is in or closest to. Otherwise, the statewide stats for the program are returned.

GET https://job-outlook.kctcsweb.com/api/program-job-outlook

Parameters

cip
Required. Program CIP, with or without the dot.
institution
Optional. Defaults to kctcs.

Institution

The options for the institution parameter are:

kctcs
Statewide stats
ashland
Ashland
bigsandy
Big Sandy
bluegrass
Bluegrass
elizabethtown
Elizabethtown
gateway
Gateway
hazard
Hazard
henderson
Henderson
hopkinsville
Hopkinsville
jefferson
Jefferson
madisonville
Madisonville
maysville
Maysville
owensboro
Owensboro
somerset
Somerset
southcentral
Southcentral
southeast
Southeast
westkentucky
West Kentucky

Response

The response is a JSON object with the following properties. An asterisk means the property is always present. Otherwise it may be null or an empty array.

*program_area The program area
post_kctcs_graduate_count The number of graduates from KCTCS
post_kctcs_graduate_count_formatted The number of graduates from KCTCS formatted
*region The region
post_kctcs_employment_rate The employment rate from KCTCS
post_kctcs_employment_rate_formatted The employment rate from KCTCS formatted
post_kctcs_median_annual_wages The median annual wages from KCTCS
post_kctcs_median_annual_wages_formatted The median annual wages from KCTCS formatted
average_annual_openings The sum of annual job openings across related occupations
average_annual_openings_formatted The sum of annual job openings across related occupations formatted
median_annual_wages The unweighted average of median annual wages for related occupations
median_annual_wages_formatted The unweighted average of median annual wages for related occupations formatted
median_entry_annual_wages The unweighted average of entry annual wages for related occupations
median_entry_annual_wages_formatted The unweighted average of entry annual wages for related occupations formatted
occupation_outlooks Up to 6 occupation outlooks, ordered by median annual wages from highest to lowest

occupation_outlooks[]

*occupation_code The O*NET code of the occupation
*occupation_title The title of the occupation
*occupation_description The description of the occupation
entry_annual_wages The entry annual wages of the occupation
entry_annual_wages_formatted The entry annual wages of the occupation formatted
median_annual_wages The median annual wages of the occupation
median_annual_wages_formatted The median annual wages of the occupation formatted
sub_occupation_descriptions An array of sub-occupation descriptions

sub_occupation_descriptions[]

*occupation_code The O*NET code of the occupation description
*occupation_title The title of the occupation description
*occupation_description The description of the occupation description