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