Autocomplete job titles

Quickstart#

Job title keywords map to peopleFilters.jobTitleKeywords on Search People. Use this endpoint to suggest matching titles as the user types.

curl -X POST "https://api.ocean.io/v2/autocomplete/job-titles" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "head of",
    "limit": 5
  }'

import requests

response = requests.post(
    'https://api.ocean.io/v2/autocomplete/job-titles',
    headers={'X-Api-Token': 'YOUR_API_TOKEN'},
    json={'query': 'head of', 'limit': 5},
)
data = response.json()

const response = await fetch('https://api.ocean.io/v2/autocomplete/job-titles', {
  method: 'POST',
  headers: { 'X-Api-Token': 'YOUR_API_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: 'head of', limit: 5 }),
});
const data = await response.json();

Example response:

{
  "jobTitles": ["Head of Sales", "Head of Marketing", "Head of Engineering", "Head of Product", "Head of Growth"]
}

Pass the selected title into jobTitleKeywords.anyOf on your people search request.

Parameters#