Skip to main content

​
Get started in three steps

​
Step 1: Get your API key

Obtain your API key from the Normalize dashboard. You will use it to authenticate all requests.

​
Step 2: Canonicalize a job title

Parse a job description and get the best matching canonical title: 
curl -X POST https://trynormalize.com/api/v1/job-titles/canonicalize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Senior Software Engineer - Full Stack"}'

​
Step 3: Booleanize a job title

Convert a job description into a boolean search string: 
curl -X POST https://trynormalize.com/api/v1/job-titles/booleanize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Senior Software Engineer - Full Stack"}'

​
Request options

Both endpoints accept single or batch input:
  • Single: Use input with a string (max 500 characters)
  • Batch: Use inputs with an array of strings (max 100 items)
  • Exclude: Optional exclude array to filter out specific titles
  • Include: Optional include array to override parsed include phrases
  • Debug: Set debug: true to include parse structure and matches in the response

​
Next steps

Canonicalize

Full documentation for the canonicalize endpoint.

Booleanize

Full documentation for the booleanize endpoint.

Bulk operations

Process CSV files asynchronously.

API reference

Overview of all endpoints.