Table of Contents
#Summary
This service will attempt to determine the level (i.e. seniority, expected experience) of a job based on its title. It will return a value from 1 to 5, along with a brief description.
The service is located at https://api.careerbuilder.com/core/tagging/joblevel. As usual, you will need OAuth credentials to use this service.
#Input Requirements
Here is an example input: api.careerbuilder.com/core/tagging/joblevel?title=software engineer
Input should be provided using the title= query parameter.
#Sample Response
{"text":"software engineer", "level":"3", "description":"Experienced (non-Manager)"}
#Response Information
The output will always contain the following three fields for a valid input:
text: the provided title
level: an integer between 1 and 5 indicating the job’s level
description: a brief description corresponding to the level
Following are all of the possible level + description pairs:
| Level | Description |
|---|---|
| 1 | Internship |
| 2 | Entry Level |
| 3 | Experienced (non-Manager) |
| 4 | Manager (Manager, Supervisor of Staff) |
| 5 | Executive (VP, SVP, Department Head, President, etc) |
The current API version is 1.0. The data returned is versioned.
Our general versioning strategy is available here.
Please email DataScienceApplicationDevelopment@careerbuilder.com if you have any questions or concerns.