Search jobs
search_jobsSearch live job postings from employer career sites and job boards by role or keywords, place, remote work, employment type and pay. Returns up to 10 job cards a page; each card has fit (every applied filter as met, partial, unknown or not_met, and a verdict of match or near_match), posting (age, freshness, last seen live), an indexed pay amount when there is one (posted by the employer only when salary.salarySource is structured, provider, page_text or extracted; otherwise unconfirmed), and the employer's title and summary as source text. coverage says what was searched and whether more pages exist; for the next page, call search_jobs again with continuationInput unchanged, which keeps the filters this search resolved, and page with offset only when it is absent. filters.jobTypes takes FULL_TIME, PART_TIME, CONTRACT or other listed types, any of which match; filters.salaryListedOnly keeps only jobs that list pay; filters.minSalary is annual pay in the requested currency, and ranges that overlap it are included. Licence requirements and eligibility are not assessed. Use it to find openings from a description; use get_job to read one posting in full, find_similar_jobs for more like a known job, list_company_jobs for one employer, and get_market_insights or get_local_demand for counts instead of jobs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| cursor | No | ||
| locale | No | ||
| offset | No | ||
| filters | No | ||
| purpose | No | ||
| variants | No | Up to 4 more wordings of the same search, such as other job titles for the same work. They run at the same time as query, with the same filters, radius, limit and page, and each counts as one search toward the search limit. Results come back in variants, one entry per wording, leaving out jobs already listed above them; repeatedJobIds names those. Use this instead of separate searches for alternative titles. | |
| commuteRadiusMiles | No | ||
| fallbackToVisitorPlace | No | When the query names no place and the search is not remote, search the signed-in person's saved country, or the country of an anonymous visitor's IP address. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | No | ||
| error | No | ||
| coverage | No | ||
| fallback | No | ||
| searchId | No | ||
| variants | No | ||
| nextSteps | Yes | ||
| totalCount | No | ||
| remainingJobs | No | ||
| assistantGuidance | Yes | ||
| continuationInput | No | ||
| totalCountIsExact | No |