Job Search
search_jobsSearch 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
Use company_name to scope results to a specific employer
Use sort='datePosted' when the user wants the newest listings instead of the most relevant
Use facets to get aggregate counts (e.g., how many results are remote vs on-site) without paging through all results
After presenting results, do NOT automatically call get_job_details for every job returned. Wait for the user to indicate which specific job(s) they're interested in, then pass that job's guid to get_job_details.
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, requires radius_unit) radius_unit: Unit for search radius. Options: 'mi', 'km' (requires radius) jobs_per_page: Number of jobs to return per page (1-100, defaults to 5) page_number: Page number for pagination (1-based, default is 1) sort: Sort order for results. Options: 'relevance', 'datePosted' (defaults to relevance) 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', 'INTERNSHIP' 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) company_name: Filter by company name fields: Specific fields to include in response (optional, returns all exposed fields by default) facets: Facet dimensions to aggregate (optional). Options: 'employmentType', 'postedDate', 'workFromHomeAvailability', 'workplaceTypes', 'employerType', 'easyApply', 'isRemote', 'willingToSponsor'
Returns:
JobSearchResult: Contains:
- data: List of JobDisplayFields with job details including:
* guid: The job's identifier to pass as job_id to get_job_details for the full
description and skills list (NOT the id field, which is a different, internal
identifier not accepted by get_job_details)
* detailsPageUrl: Direct link to full job posting
* companyPageUrl: Link to company profile page
* title, summary, salary, location, employmentType, etc.
- metadata: Search metadata with pagination info and facet results
Raises: Exception: If API call fails or input validation errors occur
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| facets | No | ||
| fields | No | ||
| radius | No | ||
| keyword | Yes | ||
| location | No | ||
| easy_apply | No | ||
| page_number | No | ||
| posted_date | No | ||
| radius_unit | No | ||
| company_name | No | ||
| jobs_per_page | No | ||
| employer_types | No | ||
| workplace_types | No | ||
| employment_types | No | ||
| willing_to_sponsor | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of job listings matching the search criteria | |
| metadata | No | Metadata about the search results and pagination |