Skip to main content
POST
/
api
/
v1
/
job-titles
/
booleanize
Booleanize job titles
curl --request POST \
  --url https://trynormalize.com/api/v1/job-titles/booleanize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "<string>",
  "inputs": [
    "<string>"
  ],
  "exclude": [
    "<string>"
  ],
  "include": [
    "<string>"
  ],
  "debug": false
}
'
{
  "boolean": "<string>",
  "confidence": 0.5,
  "needs_review": true,
  "matched_titles": [
    {
      "title": "<string>",
      "title_id": "<string>",
      "cluster": "<string>"
    }
  ],
  "excluded_terms": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

API key from the dashboard. Pass as Authorization: Bearer <key>.

Body

application/json

Use input or inputs, not both.

input
string

Single input string. Use input or inputs, not both.

Maximum string length: 500
inputs
string[]

Batch of inputs. Use input or inputs, not both.

Maximum array length: 100
exclude
string[]

Titles or keywords to exclude from results.

Maximum array length: 25
include
string[]

Override parsed include phrases.

Maximum array length: 25
debug
boolean
default:false

Include parse structure and matches in response.

Response

Success (single or batch)

boolean
string
required

Boolean search string with OR/AND/NOT and quoted terms.

confidence
number
required
Required range: 0 <= x <= 1
needs_review
boolean
required
matched_titles
object[]
required
excluded_terms
string[]
required
warnings
string[]
required

e.g. TRUNCATED_EXPANSION when boolean is truncated