GET

jobs

occupation-taxonomy

Job Search Occupation Taxonomy Helper

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

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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
Rate Limits

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.

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

Quick Example

curl 'https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy?q=DevOps&level=level2&limit=10' \
  -H 'X-API-Key: YOUR_API_KEY'

const url = new URL('https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy');
url.searchParams.set('q', 'DevOps');
url.searchParams.set('level', 'level2');
url.searchParams.set('limit', '10');

const response = await fetch(url, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.occupation_taxonomy);

import requests

response = requests.get(
    'https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'q': 'DevOps', 'level': 'level2', 'limit': 10}
)
data = response.json()
print(data['occupation_taxonomy'])

Request Parameters

string

Free-text occupation query.

string

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

integer

default:"10"

Number of taxonomy entries to return.

Response

object[]

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

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
}

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

string

level

enum<string>

Available options:

level1,

level2,

level3

limit

integer

default:10

Response

200

Occupation taxonomy helper results

Job Search Occupation Taxonomy Helper

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

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/jobs/search/occupation-taxonomy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Get Started

API Endpoints

MCP Server

CLI

Job Search Occupation Taxonomy

Job Search Occupation Taxonomy

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Job Search

Job Search Titles

Job Search Tags

Job Search Helpers

Authorizations

Query Parameters

Response

​Job Search Occupation Taxonomy

​Endpoint Details

​Quick Example

​Request Parameters

​Response

​Example Response

​Related endpoints

Job Search

Job Search Titles

Job Search Tags

Job Search Helpers

Authorizations

Query Parameters

Response

Job Search Occupation Taxonomy

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Related endpoints