Getting started with executive title classification

The ESInsight executive job title classification API classifies free-text titles using deterministic, versioned pattern matching. It is designed for executive search, CRM enrichment, market mapping, and data pipelines. This page gets you from zero to your first classified title.

Base URL

https://{api-id}.execute-api.{region}.amazonaws.com/prod

The exact host is provided to you with your API key.

Need a key? Request free trial access for 100 single-title classifications per day.

Authentication

Every request must include an API key in the x-api-key header:

x-api-key: <your-api-key>

Requests without a valid key receive 403 Forbidden.

Your first request

Classify a single title with POST /v1/classify-title:

curl -X POST "$ENDPOINT/v1/classify-title" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Interim CFO"}'

A successful response looks like this:

The classification strings below are placeholders; returned values depend on the title and active classification version.

{
  "title": "Interim CFO",
  "management_level": "<classified-value>",
  "is_non_executive": false,
  "is_partner": false,
  "is_vp": false,
  "is_owner": false,
  "function": ["<aligned-function>"],
  "standard_roles": ["<classified-role>"],
  "employment_type": "<classified-value>",
  "flag_assistant": false,
  "versions": { "taxonomy": "1.0.0", "patterns": "1.0.1" }
}

Next steps

• Classifying lists? Use the batch endpoint — one request of up to 500 titles counts as a single call against your quota.
• Understand every field in the response in Response fields.
• Check the rate limits before integrating.