Skip to main content
POST
/
v3
/
jobs
/
search
/
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"
    ]
  }
}
'

Documentation Index

Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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

HelperCredits
Resolve (this page)FREE
CompaniesFREE
Tags, Titles, Occupation Taxonomy, Locations, CatalogsFREE
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.

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

​
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

Tags

GET /v3/jobs/search/tags?q=kuber — 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.
​
companies
object
Company filters: include, exclude, and ids arrays.
​
tags
object
Tag filters: include and exclude arrays of names or IDs.
​
occupationTaxonomy
object
Taxonomy filters: level1, level2, level3 arrays of names or IDs.
​
location
object
Location filters: countries, regions, states, cities.
​
titles
object
Title filters: include and exclude arrays.

​
Response

​
resolved
object
Mirrors the request shape, with each input value replaced by { id, name, ... } objects for canonical filter IDs.
​
warnings
string[]
Any inputs that could not be resolved (typos, ambiguous matches, unsupported values).
​
credits_consumed
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
​
tags
object
​
occupationTaxonomy
object
​
location
object
​
titles
object

Response

200

Resolved filters