| dedupe | No | Merge the same role posted by the same company in several locations into one result (all locations and job IDs are kept).
Example values: true | |
| regions | No | Only jobs open to workers in these regions (e.g. 'EMEA', 'Europe', 'LATAM' postings, or any country inside the region). | |
| keywords | No | Job title/department keywords or phrases (any match). Leave empty for all remote jobs. Matched as whole words, e.g. 'software engineer', 'devops', 'customer success'.
Example values: ["software engineer","developer"] | |
| stateKey | No | Optional name for the 'only new' memory. Defaults to a hash of the filters. | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| companies | No | Only these companies (name or board slug, partial match). | |
| platforms | No | Only these ATS platforms. Leave empty for all. | |
| seniority | No | Only these seniority levels (derived from the title). | |
| enrichJobs | No | Adds an `enrichment` object to every job: salary range (min/max/currency/period + annualized, from the ATS's structured pay fields or parsed from the description), key skills and tools named in the posting, seniority level, minimum years of experience, work arrangement (from this Actor's remote/hybrid classification), employment type, visa sponsorship (when stated) and a short summary. Reads each returned job live from the employer's board (like full descriptions), so runs are slower.
[Description truncated] | |
| maxResults | No | Maximum jobs to return, newest first.
Example values: 50 | |
| salaryOnly | No | Only jobs where the posting states a salary. | |
| departments | No | Only jobs whose department contains any of these (as reported by the employer). | |
| remoteTypes | No | FULLY_REMOTE = remote job; REMOTE_OPTIONAL = remote possible but the posting also lists offices or says remote-friendly/flexible; HYBRID = some days in an office.
Example values: ["FULLY_REMOTE","REMOTE_OPTIONAL"] | |
| jobCategories | No | Only these categories (derived from title and department). | |
| minConfidence | No | high = the ATS remote flag and the location text agree; medium = one clear signal (ATS remote flag, or 'Remote' in the location or title); low = conflicting signals (e.g. ATS says on-site but the title says remote).
Example values: "medium" | medium |
| maxConcurrency | No | Parallel career-site requests when fetching descriptions.
Example values: 8 | |
| stateStoreName | No | Named key-value store that keeps the 'only new' memory in your account.
Example values: "remote-jobs-api-state" | remote-jobs-api-state |
| workerTimezone | No | Only jobs whose eligible countries/regions/stated hours overlap your time zone. Offset like 'UTC-6', '+5:30', or an IANA zone like 'America/Costa_Rica'. | |
| employmentTypes | No | Only these employment types (when the board states one). | |
| excludeKeywords | No | Skip jobs whose title contains any of these. | |
| workerCountries | No | Only jobs open to workers in these countries. ISO codes or names (US, GB, Germany, 'EU' for all EU members). Worldwide and matching-region jobs are included. | |
| excludeCompanies | No | Skip these companies (e.g. staffing agencies). | |
| firstRunEmitsAll | No | With 'Only new', the first run returns all current matches. Turn off to just record a baseline (no results, no charge) so later runs only alert on new jobs.
Example values: true | |
| postedWithinDays | No | Only jobs posted (or first seen by us) in the last N days.
Example values: 14 | |
| includeDescriptions | No | Fetch each job's live description from the career site. Also refines the remote classification with description cues (hybrid schedules, 'must be located in…', working hours) and drops jobs that have closed. | |
| onlyNewSinceLastRun | No | For scheduled runs: return only jobs not returned by an earlier run with the same filters (or the same state key). | |
| maxTimezoneDiffHours | No | How far (in hours) the job's time-zone range may be from yours.
Example values: 3 | |
| includeUnspecifiedEligibility | No | Many postings just say 'Remote' without saying where. When a country, region or time-zone filter is set, include those too (check the description). | |