job-searchlisted
Install: claude install-skill LeadMagic/leadmagic-skills
# 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](https://leadmagic.io/docs/api-reference/job-search?utm_source=github&utm_medium=skill&utm_campaign=leadmagic-skills)
## Unlimited with the right plan
**Professional and Ultimate plans search this endpoint free** — no credits, no volume
cap. The only limit is rate: **5 req/s sustained (Professional), 10 req/s (Ultimate)**.
That covers all three modes below. 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:
| Mode | Trigger | Use for |
|------|---------|---------|
| **vector** (default fast) | nothing, or `titles.vector: true` | Ranked browsing; semantic title match ("Head of Growth" also finds "VP Growth Marketing") |
| **facets** | `includeFacets: true` | Results + aggregation counts (by country, seniority, industry) — filter UIs, market breakdowns |
| **deep** | `mode: "deep"` or `includeDescription: true` | Full posting text — tool-mention mining, AI screening |
`preview` / `teaser` / `dryRun` are reserved for the LeadMagic app UI — external keys are rejected.
```bash
curl -sS -X POST "https://api.leadmagic.io/v3/j