Occupation Keyword Search - Careeronestop



CareerOneStop

Consumption Instructions: Get Occupation Summary

Last Revised: October 19, 2010

Get Occupation Summary

The Find Occupation Matches Service is a RESTful API that enables developers to query and retrieve details about an O*NET Occupation code. The returned occupation object contains jobs available in the area as reported by Job Central (), salary information, BLS job growth statistics and various O*NET occupation details. Refer to the following sections more specific information:

• Request Parameters

• Response Fields

• Errors

• Examples

Request Parameters

Refer to the following table for a list of the required and optional request parameters.  All parameter names and values are case sensitive.

Important: You must provide all required parameters. Submitting an empty request does not return all possible results; an empty request returns an error.

|Parameter |Required |Description |

|userid |Yes |This value is the unique user ID provided during the CareerOneStop web services registration|

| | |process. |

|onetcode |Yes |This is the O*NET code of the occupation to find matches for. e.g., Computer Programmers, |

| | |O*NET Code 15-1021.00 would be sent as “15102100.” |

|location |Yes |The location to use to determine available job openings, local wages, and local employment |

| | |statistics. Acceptable values are 5-digit zip codes, state names or 2-letter state |

| | |abbreviations. For national data use the numeral “0.” |

|radius |Yes |The radius, in miles of the job opportunities search area. Applies to zip code searches |

| | |only. |

Response Fields

The web service returns a XML serialized “OccupationMatchResult” with general information about the request and a matching occupation object.

OccupationMatchResult Object

|Name |Description |

|ErrorMessage |If there was a problem processing the request a message describing the error is returned. If the |

| |request was completed without error “Success” is returned. |

|ErrorNumber |Refer Error Number & Description section for more information. |

|OccupationDetails |Always null for this web service method. |

|OccupationList |Contains the Occupation object that matches the search criteria. (See Occupation object below) |

Error Number & Description

|Error Number |Description |

|106 |No Location Information Found |

|105 |No Apprenticeship Found |

|104 |No Licenses Found |

|103 |No Certfications Found |

|102 |No Training Found |

|101 |No Occupation Matches Found |

|100 |No Jobs Found |

|0 |Success |

|-1 |Database Unavailable |

|-2 |Endeca Unavailable |

|-3 |Unknow Error |

|-4 |Invalid OnetCode |

|-5 |Invalid Zipcode |

|-6 |Invalid State |

|-7 |Job Central Not Available |

|-8 |Job Central TimedOut |

|-9 |Database Error |

|-10 |No Record Found |

|-11 |Invalid Number Format |

|-12 |Invalid Distance |

|-13 |Job Count is not available for {n} job(s) – (n is number) |

|-14 |Invalid State Or ZipCode |

|-15 |ASL Geocoding Webservice Down |

|-16 |Acinet Webservice Down |

Occupation Object

|Name |Description |

|Annual Wage |Annual wage range (25th percentile – 75th percentile) |

|BrightOutlook |Returns true if the occupation is considered to have a “Bright Outlook” by O*NET. See |

| | for more information |

|CurrentlyEmployed |The number of workers currently employed in the occupation |

|GreenOccupation |Returns true if the occupation is classified as “Green” by O*NET. See |

| | for more information |

|HourlyWage |Hourly wage range (25th percentile – 75th percentile) |

|JobCount |Number of job opportunities for the occupation in the geographic search area as reported by Job |

| |Central (). |

|OccupationCode |O*NET occupation code with “-“ and “.” Omitted. |

|OccupationDescription |O*NET occupation description. |

|OccupationTitle |O*NET occupation title. |

|OpeningsPerYear |Number of estimated job openings per year over the next 10 years including people who leave their |

| |occupation and new positions created. |

|Shine |Transferability score from the selected occupation to a target occupation based on the skills. |

|Tasks |An array of O*NET task statements associated with the occupation |

|Technology |An array technologies commonly used in the occupation as determined by O*NET |

|Tools |An array of tools commonly used in the occupation as determined by O*NET |

|TotalRecords |Total number of records available for the occupation |

|TypicalTraining |Most Common Educational/Training Level achieved by workers in this occupation as determined by the |

| |US Bureau of Labor Statistics |

|VideoCode |Returns the video code associated with the occupation. |

|VideoTitle |Returns the video title associated with the video code. |

|WageAMedian |The median annual wage for the selected geographic location as determined by the state and US |

| |Bureau of Labor Statistics. |

|WageAPCT10 |The 10th percentile annual wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageAPCT25 |The 25th percentile annual wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageAPCT75 |The 75th percentile annual wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageAPCT90 |The 90th percentile annual wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageHMedian |The median hourly wage for the selected geographic location as determined by the state and US |

| |Bureau of Labor Statistics. |

|WageHPCT10 |The 10th percentile hourly wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageHPCT25 |The 25th percentile hourly wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageHPCT75 |The 75th percentile hourly wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

|WageHPCT90 |The 90th percentile hourly wage for the selected geographic location as determined by the state and|

| |US Bureau of Labor Statistics. |

General Web Service Errors (Returned in a standalone error node)

|[pic]Error |Description |

|“Invalid user ID” |The userid is not in the proper format. A user ID should be 15 alpha-numeric characters. |

|“Access to the Service Denied - This|This service has been suspended by CareerOneStop. |

|service has been suspended.” | |

|“Access to the Service Denied - This|This service has not yet become active or has expired. |

|service is not valid at this time.” | |

|“Access to the Service Denied - This|This service could not be found in CareerOneStop system. |

|service cannot be found.” | |

|“Access to the Service Denied - |This user’s usage limit for this service has been exceeded. |

|Usage limit exceeded.” | |

|“Access to the Service Denied - |This user’s subscription for this service has expired. |

|Subscription has expired.” | |

|“Access to the Service Denied - |This user’s subscription for this service has not yet become valid. |

|Subscription is not yet valid.” | |

|“Access to Service Denied - No valid|No subscription was found for this user ID and service. |

|subscription found.” | |

[pic]

Usage Example: Get Occupation Summary

Use Case #1

A user would like to see occupation details for Machinist (O*NET Code: 51-4041.00). They would like to use the zip code “55102” for the geographic center of the search and a radius of 20 miles.

Request Parameter Specifications

Refer to the following table for the parameters required to satisfy the use case above.

|Parameter |Value |

|userid |012345678901234 |

|onetcode |51404100 |

|location |55102 |

|radius |20 |

Request URL:



Results

Refer to the following for an example (code example) of results for the request parameters specified above.

| |

|Success |

|0 |

| |

| |

| |

|$35,700 - $51,800 |

|false |

|8,920 |

|false |

|$17.18 - $24.91 |

|37 |

|51404100 |

|Set up and operate a variety of machine tools to produce precision parts and instruments. Includes precision|

|instrument makers who fabricate, modify, or repair mechanical instruments. May also fabricate and modify parts to make or repair |

|machine tools or maintain industrial machines, applying knowledge of mechanics, shop mathematics, metal properties, layout, and |

|machining procedures. |

|Machinists |

|140 |

|0 |

| |

| |

|Calculate dimensions and tolerances using knowledge of mathematics and instruments such as micrometers and vernier |

|calipers. |

|Align and secure holding fixtures, cutting tools, attachments, accessories, and materials onto machines. |

|Select the appropriate tools, machines, and materials to be used in preparation of machinery work. |

|Monitor the feed and speed of machines during the machining process. |

|Machine parts to specifications using machine tools such as lathes, milling machines, shapers, or grinders. |

|Set up, adjust, and operate all of the basic machine tools and many specialized or advanced variation tools to perform |

|precision machining operations. |

|Measure, examine, and test completed units to detect defects and ensure conformance to specifications, using precision |

|instruments such as micrometers. |

|Set controls to regulate machining, or enter commands to retrieve, input, or edit computerized machine control |

|media. |

|Position and fasten work pieces. |

|Maintain industrial machines, applying knowledge of mechanics, shop mathematics, metal properties, layout, and machining |

|procedures. |

|Observe and listen to operating machines or equipment to diagnose machine malfunctions and to determine need for |

|adjustments or repairs. |

|Check work pieces to ensure that they are properly lubricated and cooled. |

|Confer with numerical control programmers to check and ensure that new programs or machinery will function properly, and |

|that output will meet specifications. |

|Lay out, measure, and mark metal stock to display placement of cuts. |

|Study sample parts, blueprints, drawings, and engineering information to determine methods and sequences of operations |

|needed to fabricate products, and determine product dimensions and tolerances. |

|Confer with engineering, supervisory, and manufacturing personnel to exchange technical information. |

|Program computers and electronic instruments such as numerically controlled machine tools. |

|Operate equipment to verify operational efficiency. |

|Clean and lubricate machines, tools, and equipment to remove grease, rust, stains, and foreign matter. |

|Establish work procedures for fabricating new structural products, using a variety of metalworking machines. |

|Fit and assemble parts to make or repair machine tools. |

|Design fixtures, tooling, and experimental parts to meet special engineering needs. |

|Set up and operate metalworking, brazing, heat-treating, welding, and cutting equipment. |

|Dismantle machines or equipment, using hand tools and power tools, to examine parts for defects and replace defective |

|parts where needed. |

|Evaluate experimental procedures, and recommend changes or modifications for improved efficiency and adaptability to |

|setup and production. |

|Install repaired parts into equipment, or install new equipment. |

|Advise clients about the materials being used for finished products. |

|Support metalworking projects from planning and fabrication through assembly, inspection, and testing, using knowledge of|

|machine functions, metal properties and mathematics. |

|Prepare working sketches for the illustration of product appearance. |

|Test experimental models under simulated operating conditions for such purposes as development, standardization, and |

|feasibility of design. |

|Install experimental parts and assemblies such as hydraulic systems, electrical wiring, lubricants, and batteries into |

|machines and mechanisms. |

| |

| |

|Project management software |

|Office suite software |

|Computer aided manufacturing CAM software |

|Computer aided design CAD software |

|Analytical or scientific software |

| |

| |

|Workshop presses |

|Milling cutters |

|Lathes |

|Gauges or inspection fixtures |

|Calipers |

| |

|0 |

|Long-term on-the-job training |

|51-4041.00 |

|Machinists |

| |

| |

|35700 |

|51800 |

| |

| |

| |

|17.18 |

|24.91 |

| |

| |

| |

| |

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download