Enrich a job title from its name
Send us a job title (e.g., chief marketing officer) and retrieve the departments and the seniority levels.
GET
https://api.thecompaniesapi.com/v2/job-titles/enrich
1 credit per request
We support the following languages: English, French, and Spanish.
Our database includes more than 165,000 job titles categorized in 70 departments and 10 seniority levels.
Signup to access all the features
Get your API token and start implementing the API in your product with 500 free credits.
No credit card required
Query parameters
namestring (required)
The job title's name.
/job-titles/enrich?name=chief%20executive%20officer
Response schema
jobTitle. departmentstring
The job title's department.
marketing
Possible values
customer service
design
education
engineering
finance
health
human resources
legal
marketing
media
Show 5 more
jobTitle. departmentSecondarystring
The job title's secondary department.
content marketing
Possible values
accounting
accounts
brand marketing
broadcasting
business development
compensation
content marketing
customer success
data
dental
Show 45 more
jobTitle. namestring
The job title's english name.
jobTitle. nameEsstring
The job title's spanish name.
jobTitle. nameFrstring
The job title's french name.
jobTitle. seniorityLevelstring
The job title's seniority level.
Possible values
owner
partner
cxo
vp
director
manager
senior
entry
training
unpaid
Code examples
Select your favorite language:
import createClient from '@thecompaniesapi/sdk'
const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })
const response = await tca.enrichJobTitles({
name: 'chief marketing officer'
})
const jobTitle = response.data // Contains department, seniority, etc.