Table of Contents
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.
HTTP method: GET or POST Parameters (query/form):
- title: (required) the job title.
Here is an example input:
HTTP GET
Accept: application/json;version=1.0
https://api.careerbuilder.com/core/tagging/joblevel?title=software engineer
{
"data": {
"level": 3,
"description": "Experienced (non-Manager)"
}
}
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) |
Our general versioning strategy is available here.
Please email [email protected] if you have any questions or concerns.