Skip to main content
GET
/
v3
/
jobs
/
search
/
titles
Job Search Titles Helper
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

MetricValue
CostFREE — 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.

​
Quick Example

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" }
      }
    }
  ]
}

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