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": [
      "stripe.com"
    ]
  },
  "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 and get canonical filter IDs before running search. Use helpers for autocomplete, filter builders, and preflight screens.

​
Pricing

Endpoint typeCredits
Resolve, autocomplete, and catalogs0 credits
Helpers do not return job rows. Use them before search to build cleaner inputs without consuming credits. POST /v3/jobs/search/resolve normalizes a draft search request into 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": ["stripe.com"] },
    "tags": { "include": ["kubernetes"] },
    "occupationTaxonomy": { "level2": ["DevOps"] },
    "location": { "countries": ["US"] }
  }'

​
Autocomplete endpoints

Companies

GET /v3/jobs/search/companies?q=stripe

Tags

GET /v3/jobs/search/tags?q=kuber

Titles

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

Occupation Taxonomy

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

Locations

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

Catalogs

GET /v3/jobs/search/catalogs
The main search route auto-resolves by default. Use helper endpoints when you want to show choices before search or avoid ambiguous fuzzy matches.

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