LeadMagic — Job search (V3)

Canonical endpoint: POST /v3/jobs/search — 46M+ open postings across corporate job boards. Aliases (same handler): /v3/jobs-search, /v3/job-search, /v2/jobs/search, /v1/jobs/search.

Docs: Job Search

Credit-free browse search on qualifying plans

On Professional and Ultimate, browse search on this endpoint costs no credits, at 5 req/s (Professional) or 10 req/s (Ultimate), within a fair-use cap (10M records/month, 13,333 searches/day) shared across People, Company and Jobs search — see leadmagic.io/unlimited. Other plans pay ~1 credit per returned job. Never ration or narrow a query to save credits on an entitled plan — go broad. Export is credit-metered on every plan.

Three modes, one endpoint

The body picks the mode; all three ride the unmetered plan entitlement:

preview / teaser / dryRun are reserved for the LeadMagic app UI — external keys are rejected.

curl -sS -X POST "https://api.leadmagic.io/v3/jobs/search" \
  -H "X-API-Key: $LEADMAGIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "titles": { "include": ["Sales Development Representative"], "vector": true },
    "location": { "countries": ["US"] },
    "postedWithin": 30,
    "limit": 25,
    "totalMode": "capped"
  }'

Filters (at least one required)

titles.include/exclude (10 each, vector flag) · companies.include/ids · location.countries/regions/states/cities/text · tags.include · occupationTaxonomy.level1/2/3 (names or IDs) · seniority · languages · jobTypeIds · industryIds · companyTypeIds · companySizeCodes · workModes (1–3) · salary.min_usd/max_usd · hasRemote · postedAfter/postedBefore (YYYY-MM-DD) or postedWithin (days, ≤365).

autoResolve: true (default) fuzzy-resolves friendly values — no exact IDs needed. totalMode: none | capped (default) | exact.

Cursor pagination

• First page: send filters + limit (1–50, default 25). No cursor.
• Response carries next_cursor (opaque string) and has_more.
• Next page: same filters + "cursor": "<next_cursor>". Changing filters mid-cursor invalidates it.
• Never combine cursor with a nonzero offset — the API rejects it.
• Stop when next_cursor is null / has_more is false.
• On Professional or Ultimate, paging is credit-free within the fair-use cap — respect the RPS.

Free helpers (0 credits, shape filters first)

Bulk export (metered on all plans)

POST /v3/jobs/search/export — same filters, limit 1–5000 (default 100), descriptions on by default, no cursor (narrow filters instead), 1 credit per returned job.

Workflow

1. Shape filters free: resolve or the GET catalogs.
2. Scan broad in vector mode; add includeFacets to see the distribution.
3. Drop to mode: "deep" only on the slice needing descriptions.
4. Page with cursor until has_more is false.
5. Need >50/page in one pull? Use export (metered) — tell the user the credit cost first.

When not to use this skill

• People/contacts at a company → people-search
• Company firmographics → company-search
• Legacy V1 listing API (/v1/jobs/jobs-finder) → docs only; prefer V3