Search jobs
search_jobsSearch live job postings: use when the user asks what jobs are open for a role, a place,
a salary or a skill. Each job carries url, its page on Nectar Jobs, where the person applies.
Args:
query: keyword or natural-language query. Words that name an occupation ("manager",
"software engineer") are matched against the TITLE; other words match the whole
document (title, company, description), so a generic word's ``total`` overcounts —
to compare role-type volumes, use aggregate_jobs instead.
location: city or country substring over the posting's location text (matches broadly:
"New York" includes the whole state). For a whole country, prefer ``country``.
remote: filter to remote (true) or on-site (false) roles.
salary_min: only roles whose salary range reaches this amount (raw number — currencies
are not converted, so only meaningful combined with a single-currency market).
company: company name substring.
source: restrict to one source/board; get_stats lists the live sources and their sizes.
seniority: one of intern, junior, senior, staff, principal, manager, director.
category: job function from the site taxonomy (Engineering, "Data & ML", Product, Design,
Sales, Marketing, "Customer Support", Operations, "Finance & Accounting",
"People & HR", Legal, "IT & Security", …) — aggregate_jobs reports the live values.
country: 2-letter ISO code ("US", "IN") — matches the derived country, more precise than
a ``location`` substring.
employment_type: contract or hours — permanent, fixed_term, contract, freelance, temporary,
casual, seasonal, internship, apprenticeship, graduate, working_student, volunteer,
self_employed, full_time, part_time, job_share, shift, term_time. Contract basis and
schedule are one filter; a posting carries one of each. Note that a posting which says
nothing about its hours is recorded as ``full_time``, so that value is the least
informative of the set.
posted_since_days: only jobs posted within this many days.
mode: "hybrid" (default, best), "semantic" (meaning-based), or "keyword" (exact).
sort: "relevance" (default), "date" (newest first), or "salary" (highest first).
page: 1-based page number, for paging past ``limit`` results.
limit: max results per page (1-100).
Returns a dict with ``total``, a ``jobs`` list (duplicates collapsed) and ``attribution``;
when nothing matched, a ``hint`` names the filter most worth loosening.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | hybrid | |
| page | No | ||
| sort | No | relevance | |
| limit | No | ||
| query | No | ||
| remote | No | ||
| source | No | ||
| company | No | ||
| country | No | ||
| category | No | ||
| location | No | ||
| seniority | No | ||
| salary_min | No | ||
| employment_type | No | ||
| posted_since_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||