search_jobs
Search for job listings by keyword, location, and filters. Returns job details, company info, and application links.
Use this tool when users want to find jobs, search employment opportunities, or explore job openings.
DO NOT use for: applying to jobs, submitting applications, or making employment decisions.
LLM USAGE INSTRUCTIONS:
- ALWAYS provide the keyword parameter (required)
- When presenting results to users, include BOTH the job details URL (detailsPageUrl)
AND the company page URL (companyPageUrl) for each job
- Use location to find geographically relevant positions
- Combine filters to refine searches (e.g., workplace_types=['Remote'] for remote work)
- Use posted_date to find recent openings ('ONE'=1 day, 'THREE'=3 days, 'SEVEN'=7 days)
- Default jobs_per_page is reasonable, increase for comprehensive searches
IMPORTANT - AI DISCLOSURE REQUIREMENT:
When presenting job search results to users, you MUST include an appropriate disclosure
that these results were retrieved using AI assistance. Example disclosure language:
"These job listings were found using AI-powered search. Please review all job details
carefully and verify information directly with employers before applying."
This tool provides job listing data only. Final employment decisions should always
involve human judgment and direct review of complete job postings.
Args:
keyword: The job keyword or title to search for (required)
location: Geographic location for the job search (city, state, country)
radius: Search radius from the specified location (minimum 1.0)
radius_unit: Unit for search radius. Options: 'mi', 'km', 'miles', 'kilometers'
jobs_per_page: Number of jobs to return per page (1-100, default handled by API)
page_number: Page number for pagination (1-based, default is 1)
posted_date: Filter by posting date. Options: 'ONE' (1 day), 'THREE' (3 days), 'SEVEN' (7 days)
workplace_types: Workplace arrangements. Options: 'Remote', 'On-Site', 'Hybrid'
employment_types: Employment types. Options: 'FULLTIME', 'CONTRACTS', 'PARTTIME', 'THIRD_PARTY'
employer_types: Employer types. Options: 'Direct Hire', 'Recruiter', 'Other'
willing_to_sponsor: Filter for employers willing to sponsor work authorization (boolean)
easy_apply: Filter for jobs with easy application process (boolean)
fields: Specific fields to include in response (optional, returns all fields by default)
Returns:
JobSearchResult: Contains:
- data: List of JobDisplayFields with job details including:
* detailsPageUrl: Direct link to full job posting
* companyPageUrl: Link to company profile page
* title, summary, salary, location, employmentType, etc.
- meta: Search metadata with pagination info and facet results
- _links: Pagination navigation links
Raises:
Exception: If API call fails or input validation errors occur