Job titles are hard to automate because humans write them.

New titles are invented daily, and spelling mistakes happen. Hence basic text comparison quickly becomes unhelpful.

Our machine-learning API sorts job titles into two ensembles: field (e.g. "sales, finance, I.T...") and role (e.g. "exec, management, assistant...") so you can prioritize the ones you're interested in.

How to use

const predictions = await fetch("<https://jobtitlesai.com/api/categorize?jobtitle=head+of+growth&key=****>").then(r => r.json())

// [
//   {
//     jobtitle: "head of growth",
//     fields: [ { confidence: 0.9972090721130371, label: "marketing" } ],
//     roles: [ { confidence: 1.0000100135803223, label: "manager" } ]
//   }
// ]
const predictions = await fetch("<https://jobtitlesai.com/api/categorize>", {
	method: "POST",
	headers: {
		"Content-Type": "application/json",
		"x-api-key": "***",
	},
	body: JSON.stringify([ // note the array
		"head of growth",
		"responsable rh",
	])
}).then(r => r.json())

// [
//   {
//     jobtitle: "head of growth",
//     fields: [ { confidence: 0.9972090721130371, label: "marketing" } ],
//     roles: [ { confidence: 1.0000100135803223, label: "manager" } ]
//   }
// ]

<aside> 💡 - Note the response is always an array, even if you send only one job title. ([])

</aside>

Get your API key

👉 Ask us in the support chat

Available fields and roles

Fields

The fields property refers to a list of domains/departments that the person practices in at a given company. Not to be confused with the industry/sector of the company.

<aside> 🧠 You can be Human Resource Director in the real estate industry, or communication manager in an IT company.

</aside>

Roles

The roles property refers to a somewhat hierarchical structure that can be used to know at which “level” of responsibility the job title refers. It does not consider years of experience (titles such as senior) because you can be a young CEO or an experienced sales caller.

But we’re happy to get your feedback on this.