Job Search Occupation Taxonomy

Autocomplete occupation taxonomy values for Job Search.

GET /v3/jobs/search/occupation-taxonomy

Job Search Occupation Taxonomy Helper

cURL

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

Job Search Occupation Taxonomy

Occupation taxonomy autocomplete for Job Search. The taxonomy is a broad-to-specific hierarchy that maps free-text occupation queries to canonical IDs and labels.

Level	Meaning	Example
level1	Broad occupation family	”Engineer”
level2	Occupation category	”DevOps”
level3	Normalized job title	”DevOps Engineer”

Endpoint Details

Pricing

Metric	Value
Cost	FREE — 0 credits per request

Occupation taxonomy autocomplete is free. Use this for filter-builder UIs that need a structured taxonomy picker.

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/occupation-taxonomy?q=DevOps&level=level2&limit=10' \
  -H 'X-API-Key: YOUR_API_KEY'

---

Request Parameters

q · string

Free-text occupation query.

level · string

Restrict results to a single level. One of level1, level2, or level3. Omit to return matches across all levels.

limit · integer · default: "10"

Number of taxonomy entries to return.

---

Response

occupation_taxonomy · object[]

Matching taxonomy entries with id, name, level metadata, and a human-readable path.

credits_consumed · number

Always 0 for this helper.

Example Response

{
  "occupation_taxonomy": [
    {
      "id": 1700834,
      "name": ".NET & DevOps",
      "type": 2,
      "level1": { "id": 7, "name": "Engineer" },
      "level2": { "id": 1700834, "name": ".NET & DevOps" },
      "level3": null,
      "path": "Engineer > .NET & DevOps"
    }
  ],
  "credits_consumed": 0
}

---

Related endpoints

Job Search

Pass occupationTaxonomy.level1/2/3 arrays into search.

Job Search Titles

Find specific job titles within a taxonomy branch.

Job Search Tags

Tags often map to taxonomy nodes — pair them in filter builders.

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

level · enum<string>

Available options: level1, level2, level3

limit · integer · default: 10

Response

200

Occupation taxonomy helper results