Enrich job titles via API
Normalize messy job titles into seniority + function + department.
AuthorizationBearer clnl_live_…
Content-Typeapplication/json
{
"email": "jane@acme.com"
}- 1 creditA verified work email, however many providers it took to find it.
- 11 creditsEmail and direct dial together, on the same call.
- 25+ providersQueried in cost order. The first source that returns wins, and a miss costs nothing.
- 98% / 85%Verified work email and direct dial, measured on a 500-lead stratified test.
One call in.5 fields back.
The payload for a single job title lookup, and every field the record can carry. Same shape on every plan.
{
"id": "ev_abc123",
"job_title": {
"raw_title": "<raw_title>",
"normalized_title": "<normalized_title>",
"seniority": "<seniority>",
"department": "<department>",
"function": "<function>"
},
"meta": {
"credits_used": 11,
"providers_queried": 25
}
}- raw_titlestring
- normalized_titlestring
- senioritystring
- departmentstring
- functionstring
Call it from anything.Pay for what comes back.
One POST from curl, Node or Python. Credits are drawn from one wallet the whole team shares, and a call that finds nothing is never charged.
curl
curl -X POST https://api.cleanlist.ai/v1/enrich/job_title \
-H "Authorization: Bearer $CLEANLIST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "jane@acme.com"}'Node.js
import Cleanlist from "cleanlist";
const client = new Cleanlist(process.env.CLEANLIST_API_KEY);
const result = await client.enrich.job_title({
email: "jane@acme.com",
});
console.log(result.job_title.title);Python
from cleanlist import Cleanlist client = Cleanlist(api_key=os.environ["CLEANLIST_API_KEY"]) result = client.enrich.job_title(email="jane@acme.com") print(result["job_title"]["title"])
- SearchFree, unlimited
- Verified work email1 credit
- Direct dial10 credits
- Email and direct dial11 credits
- Validation0.5 credits
- AI qualification5 credits
- A call that finds nothing0
One shared wallet across the team. The Free plan runs on 30 credits a month.
Enrich job titles in production.
The public API is on Pro and Scale. Search costs nothing on every plan, and a call that returns nothing is never charged.
Related reading: data enrichment and waterfall enrichment. Plans and credit rates are on pricing.