Search jobs
search_jobsSearch Jobven job postings with the filters of GET /v1/public/jobs. Returns 10 jobs by default (at most 25) with a plain-text excerpt of each description; get_job has the full text. Pass nextCursor back as cursor, with the same filters, for the next page. Each job returned counts toward the monthly allowance.
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 |
|---|---|---|---|
| q | No | Search job titles by whole word. Words are ANDed in any order; "double quotes" match an exact phrase, OR matches either side, and a leading - excludes a word. Case-insensitive. Does not search descriptions (see descriptionQuery). | |
| ats | No | Platform the posting is published on, any of, e.g. ["workday", "greenhouse"] | |
| city | No | City, comma-separated; case and accents are ignored | |
| limit | No | Jobs per page, default 10, at most 25 | |
| order | No | Default DESC | |
| state | No | State, province or region, comma-separated: full name ("Ontario") or, for the US and Canada, the postal code ("ON") | |
| cursor | No | nextCursor from the previous search_jobs result, same filters | |
| skills | No | Skills, any of (up to 10), e.g. ["typescript", "react"] | |
| sortBy | No | Sort field (default postedAt) | |
| status | No | "active" (the default) or "closed" | |
| country | No | ISO 3166-1 alpha-2 country code, e.g. "US", "CA", "GB". "XX" matches jobs with no location at all. | |
| industry | No | Industries, any of (up to 10) | |
| language | No | Required spoken language, ISO 639-1 code, e.g. "fr" | |
| location | No | Free-text location: city, region or country | |
| maxSalary | No | Maximum yearly starting pay, as minSalary | |
| minSalary | No | Minimum yearly pay; hourly, daily, weekly and monthly pay is compared per year. In each job's own currency unless salaryCurrency is set | |
| remoteType | No | Remote type, any of | |
| closedAfter | No | Closed at or after (Unix seconds), by closedAt; requires status "closed" | |
| listedAfter | No | Listed at or after (Unix seconds), by listedAt: for incremental sync | |
| postedAfter | No | Posted at or after (Unix seconds) | |
| includeTotal | No | Also count every match (slower) | |
| postedBefore | No | Posted before (Unix seconds) | |
| hasRelocation | No | true: postings that offer relocation help; false: postings that say they do not | |
| employmentType | No | Employment type, any of | |
| salaryCurrency | No | ISO 4217 currency code of the salary, e.g. USD, EUR, PLN | |
| experienceLevel | No | Experience level, any of | |
| descriptionQuery | No | Search job descriptions for a whole-word phrase, matched literally, case-insensitive. Slower than the other filters; pair it with postedAfter. | |
| hasVisaSponsorship | No | true: postings that offer visa sponsorship; false: postings that say they do not |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | ||
| total | No | ||
| hasMore | Yes | ||
| request | Yes | The REST call this result came from. curl reads the key from $JOBVEN_API_KEY. | |
| nextCursor | No |