POST

jobs

resolve

Resolve Job Search filters

curl --request POST \
  --url https://api.leadmagic.io/v3/jobs/search/resolve \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "companies": {
    "include": [
      "leadmagic.io"
    ]
  },
  "tags": {
    "include": [
      "kubernetes"
    ]
  },
  "occupationTaxonomy": {
    "level2": [
      "DevOps"
    ]
  },
  "location": {
    "countries": [
      "US"
    ]
  },
  "titles": {
    "include": [
      "Site Reliability Engineer"
    ]
  }
}
'

import requests

url = "https://api.leadmagic.io/v3/jobs/search/resolve"

payload = {
    "companies": { "include": ["leadmagic.io"] },
    "tags": { "include": ["kubernetes"] },
    "occupationTaxonomy": { "level2": ["DevOps"] },
    "location": { "countries": ["US"] },
    "titles": { "include": ["Site Reliability Engineer"] }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    companies: {include: ['leadmagic.io']},
    tags: {include: ['kubernetes']},
    occupationTaxonomy: {level2: ['DevOps']},
    location: {countries: ['US']},
    titles: {include: ['Site Reliability Engineer']}
  })
};

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

package main

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

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/resolve"

	payload := strings.NewReader("{\n  \"companies\": {\n    \"include\": [\n      \"leadmagic.io\"\n    ]\n  },\n  \"tags\": {\n    \"include\": [\n      \"kubernetes\"\n    ]\n  },\n  \"occupationTaxonomy\": {\n    \"level2\": [\n      \"DevOps\"\n    ]\n  },\n  \"location\": {\n    \"countries\": [\n      \"US\"\n    ]\n  },\n  \"titles\": {\n    \"include\": [\n      \"Site Reliability Engineer\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	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/resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'companies' => [
        'include' => [
                'leadmagic.io'
        ]
    ],
    'tags' => [
        'include' => [
                'kubernetes'
        ]
    ],
    'occupationTaxonomy' => [
        'level2' => [
                'DevOps'
        ]
    ],
    'location' => [
        'countries' => [
                'US'
        ]
    ],
    'titles' => [
        'include' => [
                'Site Reliability Engineer'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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 Helpers

Helpers let your frontend send friendly values (a company name, a tag, a country code) and get back canonical filter IDs before running Job Search. Use them for autocomplete, filter builders, and preflight validation screens.

Endpoint Details

Pricing
Rate Limits

Helper	Credits
Resolve (this page)	FREE
Companies	FREE
Tags, Titles, Occupation Taxonomy, Locations, Catalogs	FREE

The main Job Search route auto-resolves friendly values when autoResolve: true. Use these helpers directly when you want to show choices before search, or to avoid ambiguous fuzzy matches in production.

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

Quick Example

Resolve a draft search request into canonical filter IDs and labels:

curl -X POST 'https://api.leadmagic.io/v3/jobs/search/resolve' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "companies": { "include": ["leadmagic.io"] },
    "tags": { "include": ["kubernetes"] },
    "occupationTaxonomy": { "level2": ["DevOps"] },
    "location": { "countries": ["US"] },
    "titles": { "include": ["Site Reliability Engineer"] }
  }'

const response = await fetch('https://api.leadmagic.io/v3/jobs/search/resolve', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    companies: { include: ['leadmagic.io'] },
    tags: { include: ['kubernetes'] },
    occupationTaxonomy: { level2: ['DevOps'] },
    location: { countries: ['US'] },
    titles: { include: ['Site Reliability Engineer'] }
  })
});
const data = await response.json();
console.log(data.resolved);

import requests

response = requests.post(
    'https://api.leadmagic.io/v3/jobs/search/resolve',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={
        'companies': {'include': ['leadmagic.io']},
        'tags': {'include': ['kubernetes']},
        'occupationTaxonomy': {'level2': ['DevOps']},
        'location': {'countries': ['US']},
        'titles': {'include': ['Site Reliability Engineer']}
    }
)
data = response.json()
print(data['resolved'])

Autocomplete endpoints

Each autocomplete helper has its own page with full request/response docs and an interactive playground:

Companies

GET /v3/jobs/search/companies?q=leadmagic — FREE

Titles

GET /v3/jobs/search/titles?q=devops engineer — FREE

Occupation Taxonomy

GET /v3/jobs/search/occupation-taxonomy?q=DevOps&level=level2 — FREE

Locations

GET /v3/jobs/search/locations?type=country&q=United — FREE

Catalogs

GET /v3/jobs/search/catalogs — FREE

Resolve request parameters

The resolve endpoint accepts the same filter blocks as Job Search, but instead of running a search it returns canonical IDs and labels for whatever you passed in.

object

Company filters: include, exclude, and ids arrays.

object

Tag filters: include and exclude arrays of names or IDs.

object

Taxonomy filters: level1, level2, level3 arrays of names or IDs.

object

Location filters: countries, regions, states, cities.

object

Title filters: include and exclude arrays.

Response

object

Mirrors the request shape, with each input value replaced by { id, name, ... } objects for canonical filter IDs.

string[]

Any inputs that could not be resolved (typos, ambiguous matches, unsupported values).

number

Always 1 for this helper.

Cache resolve responses for the lifetime of a user session. The same friendly inputs will resolve to the same canonical IDs.

Job Search

Run search with the resolved filter IDs.

Job Search

Discover which filter dimensions are searchable.

Job Search Catalogs

Full static filter catalogs (countries, job types, etc.).

Facets in Job Search

Get filter counts alongside search results.

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).

Body

application/json

companies

object

Show child attributes

Response

200

Resolved filters

Resolve Job Search filters

curl --request POST \
  --url https://api.leadmagic.io/v3/jobs/search/resolve \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "companies": {
    "include": [
      "leadmagic.io"
    ]
  },
  "tags": {
    "include": [
      "kubernetes"
    ]
  },
  "occupationTaxonomy": {
    "level2": [
      "DevOps"
    ]
  },
  "location": {
    "countries": [
      "US"
    ]
  },
  "titles": {
    "include": [
      "Site Reliability Engineer"
    ]
  }
}
'

import requests

url = "https://api.leadmagic.io/v3/jobs/search/resolve"

payload = {
    "companies": { "include": ["leadmagic.io"] },
    "tags": { "include": ["kubernetes"] },
    "occupationTaxonomy": { "level2": ["DevOps"] },
    "location": { "countries": ["US"] },
    "titles": { "include": ["Site Reliability Engineer"] }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    companies: {include: ['leadmagic.io']},
    tags: {include: ['kubernetes']},
    occupationTaxonomy: {level2: ['DevOps']},
    location: {countries: ['US']},
    titles: {include: ['Site Reliability Engineer']}
  })
};

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

package main

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

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/resolve"

	payload := strings.NewReader("{\n  \"companies\": {\n    \"include\": [\n      \"leadmagic.io\"\n    ]\n  },\n  \"tags\": {\n    \"include\": [\n      \"kubernetes\"\n    ]\n  },\n  \"occupationTaxonomy\": {\n    \"level2\": [\n      \"DevOps\"\n    ]\n  },\n  \"location\": {\n    \"countries\": [\n      \"US\"\n    ]\n  },\n  \"titles\": {\n    \"include\": [\n      \"Site Reliability Engineer\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	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/resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'companies' => [
        'include' => [
                'leadmagic.io'
        ]
    ],
    'tags' => [
        'include' => [
                'kubernetes'
        ]
    ],
    'occupationTaxonomy' => [
        'level2' => [
                'DevOps'
        ]
    ],
    'location' => [
        'countries' => [
                'US'
        ]
    ],
    'titles' => [
        'include' => [
                'Site Reliability Engineer'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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 Helpers

Job Search Helpers

Endpoint Details

Quick Example

Autocomplete endpoints

Companies

Tags

Titles

Occupation Taxonomy

Locations

Catalogs

Resolve request parameters

Response

Job Search

Job Search

Job Search Catalogs

Facets in Job Search

Authorizations

Body

Response

​Job Search Helpers

​Endpoint Details

​Quick Example

​Autocomplete endpoints

Companies

Tags

Titles

Occupation Taxonomy

Locations

Catalogs

​Resolve request parameters

​Response

​Related endpoints

Job Search

Job Search

Job Search Catalogs

Facets in Job Search

Authorizations

Body

Response

Job Search Helpers

Endpoint Details

Quick Example

Autocomplete endpoints

Resolve request parameters

Response

Related endpoints