Job Search Catalogs

Fetch filter catalogs and dimension summaries for Job Search.

GET /v3/jobs/search/catalogs

Job Search Catalogs

cURL

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

Job Search Catalogs

Fetch the full set of filter catalogs for Job Search — countries, regions, job types, industries, company types, seniority values, and dataset stats — in one call. Use this to populate static filter dropdowns in your UI.

Endpoint Details

Pricing

Metric	Value
Cost	FREE — 0 credits per request

Cache the catalog response on your side — these dimensions change infrequently. Refresh on a daily or weekly schedule.

Rate Limits

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

Rate limits are subject to change. Contact us for enterprise plans — [e-mail].

---

Quick Example

cURL

curl 'https://api.leadmagic.io/v3/jobs/search/catalogs' \
  -H 'X-API-Key: YOUR_API_KEY'

---

Request Parameters

This endpoint takes no parameters.

---

Response

countries · object[]

Country catalog with id and name.

regions · object[]

Region catalog with id and name.

job_types · object[]

Job-type catalog (full-time, part-time, contract, etc.).

industries · object[]

Industry catalog.

company_types · object[]

Company-type catalog (private, public, non-profit, etc.).

seniority · object[]

Seniority catalog.

stats · object

Public-safe Jobs Search coverage stats included with the catalog response.

Example Response

{
  "countries": [
    { "id": 840, "name": "United States" },
    { "id": 826, "name": "United Kingdom" }
  ],
  "job_types": [
    { "id": 1, "name": "Full-time" },
    { "id": 2, "name": "Part-time" },
    { "id": 3, "name": "Contract" }
  ],
  "industries": [
    { "id": 96, "name": "Software" }
  ],
  "company_types": [
    { "id": 1, "name": "Private" },
    { "id": 2, "name": "Public" }
  ],
  "seniority": [
    { "id": 1, "name": "Entry" },
    { "id": 5, "name": "VP" }
  ],
  "stats": {
    "total_jobs_indexed": 12500000,
    "freshness_days": 1
  }
}

---

Related endpoints

Job Search Locations

Search location filters (states, cities) not in the static catalog.

Job Search

Use catalog IDs in jobTypeIds, industryIds, companyTypeIds, etc.

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

Response

200

Catalog response