Job function & level lookup

Resolve a list of job titles to their canonical Sumble job function and level. Pass a titles array (1–1000 entries) and receive one entry in results for every input, in the same order you supplied them.

Each result pairs the original input title with two classifications: job_function and job_level. Either may be null when no confident match is available for that classification. The job_level includes a level_rank that orders levels from individual contributor to executive.

The response also returns matched_count, the number of titles that resolved to at least one classification.

Use this endpoint when you have a list of raw job titles and need structured, queryable identifiers — for example, to normalize titles from a CSV before passing job function or level filters to the people or jobs endpoints.

Credit cost

1 credit per 100 matched titles. Unmatched titles do not consume credits.

Look up the function and level for job titles

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

titlesstring[] · min: 1 · max: 1000Required

List of job titles to look up

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

matched_countintegerRequired

422

Validation Error

application/json

post/v9/jobs/title-lookup

HTTPcURLJavaScriptPython

POST /v9/jobs/title-lookup HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "titles": [
    "software engineer",
    "senior data scientist"
  ]
}

{
  "id": "019c9529-9d27-7e16-b721-76d18c339e3e",
  "credits_used": 1,
  "credits_remaining": 999,
  "matched_count": 2,
  "results": [
    {
      "input": "software engineer",
      "job_function": {
        "id": 97,
        "slug": "software-engineer",
        "name": "Software Engineer"
      },
      "job_level": {
        "id": -1,
        "name": "Individual Contributor",
        "level_rank": 0
      }
    },
    {
      "input": "senior data scientist",
      "job_function": {
        "id": 74,
        "slug": "data-scientist",
        "name": "Data Scientist"
      },
      "job_level": {
        "id": 18,
        "name": "Senior",
        "level_rank": 1
      }
    }
  ]
}