Job Search Titles

Autocomplete job titles for Job Search title filters.

GET /v3/jobs/search/titles

Job Search Titles Helper

cURL

curl --request GET \
  --url https://api.leadmagic.io/v3/jobs/search/titles \
  --header 'X-API-Key: <api-key>'

Job Search Titles

Title autocomplete for Job Search filter builders. Discover searchable title phrases with occupation taxonomy metadata before running search.

Endpoint Details

Pricing

Metric	Value
Cost	FREE — 0 credits per request

Title autocomplete is free. In Job Search, set titles.vector: true when exact title keywords are too narrow for your users.

Rate Limits

Metric	Value
Requests/Minute	300
Burst Capacity	~5 requests/second

Rate limits are subject to change. Contact us for enterprise plans — [e-mail].

---

Quick Example

cURL

curl 'https://api.leadmagic.io/v3/jobs/search/titles?q=devops%20engineer&limit=10' \
  -H 'X-API-Key: YOUR_API_KEY'

---

Request Parameters

q · string

Free-text title query.

limit · integer · default: "10"

Number of title candidates to return.

---

Response

titles · object[]

Matching titles with id, name, and any associated occupation taxonomy metadata.

Example Response

{
  "titles": [
    {
      "id": 774,
      "name": "DevOps Engineer",
      "occupation_taxonomy": {
        "level1": { "id": 1, "name": "Developer" },
        "level2": { "id": 20, "name": "DevOps" },
        "level3": { "id": 774, "name": "DevOps Engineer" }
      }
    }
  ]
}

---

Related endpoints

Job Search

Run search using the resolved title phrases.

Semantic Title Matching

Use titles.vector: true when exact keywords are too narrow.

Occupation Taxonomy

Browse the canonical taxonomy levels.

Job Search Helpers

Index of all filter helpers.

Authorizations

X-API-Key · string · header · required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Query Parameters

q · string

limit · integer · default: 10

Response

200

Title helper results