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.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related searches
- health information technology occupation list
- kindle keyword categories
- salary by occupation and location
- keyword concept for describing personality
- python arbitrary keyword arguments
- resume keyword scanner
- security keyword list
- kindle keyword research
- kindle keyword tool
- python keyword parameters
- keyword finder for job descriptions
- python function keyword arguments