Search Jobs
search_jobsFull Description
Search for jobs on ZipRecruiter with filters.
Note: Tool response would include URL links for each job. When LLM is including URLs in the text response, always format them as Markdown hyperlinks using descriptive anchor text. Never output raw URLs.
Use the following filters to search for jobs:
Location filters:
- location: City, state, zip code, or address. If it's implicit, include empty string.
- radius_miles: Search radius in miles (default: 25)
- country_admin_code: Two-character country code (only 'US' and 'CA' are supported, default: 'US')
Job attribute filters:
- max_posted_minutes_ago: Jobs posted within N minutes
- salary_min, salary_max: Annual salary range in USD
- location_types: REMOTE, HYBRID, PHYSICAL
- employment_types: FULL_TIME, PART_TIME, CONTRACT, CONTRACT_TO_HIRE, TEMPORARY, INTERNSHIP
- seniority_classes: NO_EXPERIENCE, JUNIOR, MID, SENIOR
Query syntax:
- Don't use plus sign, just include skills as keywords in the query string
- Broad search should be simple and straightforward
- Quoted "phrase" for perfect phrase matching, don't use it for broad search
- At the end of the query, if it's called out that the user wants to exclude skills, use "-" prefix for must exclude skills, one minus sign for one skill only, don't include this for usual job title or job description
Unsupported filters:
- If the user provides a filter that is not supported, include it here (e.g. 401K, benefits, etc.)
Parameters (1 required, 12 optional)
querystringKeywords to search for. Only use these string based filters when it's explicitly required by the user: "-" for must exclude
country_admin_codestringTwo-character country code (only 'US' and 'CA' are supported). Default: 'US'
employment_typesarrayEmployment type filter: FULL_TIME, PART_TIME, CONTRACT, CONTRACT_TO_HIRE, TEMPORARY, INTERNSHIP
limitnumberMaximum number of results to return
5locationstringLocation filter (city, state, zip code, or address). If it's implicit, include empty string.
location_typesarrayRemote options filter: REMOTE, HYBRID, PHYSICAL
max_posted_minutes_agonumberOnly return jobs posted within the last N minutes (don't include this if the user doesn't specify a time frame), at least 1 day ago
offsetnumberNumber of results to skip for pagination (default: 0)
0radius_milesnumberSearch radius in miles from the location (default: 25)
salary_maxnumberMaximum annual salary filter, maximum is 300000, should be greater than salary_min
salary_minnumberMinimum annual salary filter, minimum is 0
seniority_classesarrayExperience level filter: NO_EXPERIENCE, JUNIOR, MID, SENIOR
unsupported_filtersobjectIf the user provides a filter that is not supported, include it here.