Search jobs
search_jobsRead-onlyIdempotent
Search current hiring posts from Reddit's job subreddits, newest first. With no filters, returns the newest open jobs. Each result has pay, type, location, skills, any scam warning, the Only Hiring link and the Reddit link to apply.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Any of these role categories. | |
| limit | No | Most jobs to return, newest first. | |
| query | No | Words to look for in the job title, summary, skills and role, e.g. "python scraper". Every word must match. | |
| region | No | A country or region the user is in, e.g. "Canada" or "EU". Keeps remote jobs open worldwide or to that region, and jobs located there. | |
| skills | No | Skills the job must list, e.g. ["React", "TypeScript"]. Every skill must match one of the job's skills. | |
| min_pay | No | Lowest acceptable pay in pay_type units, e.g. 40 with pay_type hourly for $40/hr. Compared with the top of each job's stated range; jobs that state no amount are left out. | |
| currency | No | ISO currency code that min_pay is in. Only jobs paying in this currency pass a min_pay filter. | USD |
| pay_type | No | How the job pays. Required with min_pay. Any of: hourly (Hourly), daily (Daily), weekly (Weekly), monthly (Monthly), yearly (Yearly), fixed_project (Fixed price), per_unit (Per piece), commission_only (Commission only), equity_or_revenue_share (Equity / revenue share). | |
| subreddit | No | Only jobs from this subreddit, e.g. "forhire". See list_subreddits. | |
| work_mode | No | Any of: remote, hybrid, onsite. | |
| max_scam_score | No | Highest scam score to include, 0–1. Defaults to leaving out likely scams (0.6 or more). Use 0.39 for only jobs without a warning. | |
| employment_type | No | Any of: full_time (Full-time), part_time (Part-time), contract (Contract), freelance_project (Freelance project), internship (Internship). | |
| posted_within_days | No | Only jobs posted in the last N days, up to 60. The board treats jobs older than 14 days as likely filled. |