# Remote Jobs Scraper - 7 Boards, Salaries & Leads (`scrapesage/remote-jobs-scraper`) Actor
Aggregate remote jobs from RemoteOK, Remotive, WeWorkRemotely, Himalayas, Jobicy, Arbeitnow & Working Nomads in one run: salary, skills, location, full description & apply link. Filter by keyword, salary & date. Company leads + monitoring for new jobs. JSON, CSV, Excel.
- **URL**: https://apify.com/scrapesage/remote-jobs-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 remote job listings
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Remote Jobs Scraper — 7 Boards in One Run (Salaries, Skills & Company Leads)
Aggregate **remote job listings from the 7 biggest remote job boards in a single run** — **RemoteOK, Remotive, WeWorkRemotely, Himalayas, Jobicy, Arbeitnow and Working Nomads** — normalized into one clean dataset with **salaries, skills, candidate-location & timezone restrictions, full descriptions and apply links**. Optionally turn every hiring company into a **ready-to-contact B2B lead** (website, emails, phone, socials) and run it on a schedule to capture **only newly posted jobs**.
No login, no API key, no browser — fast JSON extraction from public endpoints with high reliability. Every source is keyless and the actor keeps running even if one board is temporarily unavailable.
### Why this remote jobs scraper?
Most remote-job scrapers cover a single board and return a thin row. This actor merges **seven** boards, de-duplicates the same role re-posted across them, and ships the **richest, most complete remote-jobs dataset in the category** — with structured salary, normalized job type, skills, and the company-lead layer no single-board scraper has.
| Data | Single-board scrapers | This actor |
|---|---|---|
| Boards covered in one run | 1 | ✅ **7** (RemoteOK, Remotive, WeWorkRemotely, Himalayas, Jobicy, Arbeitnow, Working Nomads) |
| Structured salary (min/max/currency/period) | ❌ rarely | ✅ parsed even from free-text salary strings |
| Skills / tags | partial | ✅ |
| Candidate-location & **timezone** restrictions | ❌ | ✅ |
| Normalized job type (full-time/contract/intern…) | ❌ | ✅ |
| Full job description (clean text + optional HTML) | partial | ✅ |
| Cross-board de-duplication | ❌ | ✅ |
| **Hiring-company leads** (website, emails, phone, socials, lead score) | ❌ | ✅ opt-in |
| Monitor mode — only new jobs | ❌ | ✅ |
| Filter by keyword, category, location, salary, date | partial | ✅ |
### Use cases
- **Job boards & aggregators** — power your own remote-work board, newsletter, Slack/Telegram channel or app with fresh, structured listings from seven sources at once.
- **Lead generation** — companies hiring remotely are buying: ATS/HR tools, dev agencies, recruiters, relocation/PEO/payroll, coworking and SaaS. Score them by hiring volume and reach them directly with `enrichCompanyContacts` (`emails`, `phone`, `website`, `socialLinks`, `leadScore`).
- **Recruiting & sourcing** — track new roles by stack (`python`, `react`, `golang`), seniority and region; spot which companies are scaling.
- **Market & salary intelligence** — analyze remote salary ranges, in-demand skills, and hiring trends by category and candidate region.
- **Job alerts** — schedule the actor with **monitor mode** to push only newly posted jobs into a CRM, sheet, or chat.
### How to use
1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **Remote Jobs Scraper**, add search keywords (or leave empty for the latest jobs), pick boards/filters, and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).
### Input
```json
{
"searchQueries": ["python", "react"],
"sources": ["remoteok", "remotive", "weworkremotely", "himalayas", "jobicy", "arbeitnow", "workingnomads"],
"candidateLocation": ["USA", "Worldwide"],
"jobType": "full-time",
"salaryMin": 80000,
"postedWithinDays": 7,
"outputType": "all",
"maxItems": 300,
"enrichCompanyContacts": true
}
````
- **searchQueries** — keywords matched against title, company, skills and description (ANY match). Leave empty to pull the latest remote jobs from every selected board.
- **sources** — which boards to aggregate (`remoteok`, `remotive`, `weworkremotely`, `himalayas`, `jobicy`, `arbeitnow`, `workingnomads`). Empty = all 7.
- **categories** — filter by category/industry/tags (`software development`, `marketing`, `design`, `customer support`, `sales`, `data`, …).
- **candidateLocation** — filter by where candidates may be based (`USA`, `Europe`, `United Kingdom`, `LATAM`, `Worldwide`). Worldwide/Anywhere jobs always pass.
- **companyNames** — keep only jobs from specific employers.
- **jobType / seniority / salaryMin / postedWithinDays** — narrow the results. `salaryMin` keeps only jobs whose published salary clears the floor.
- **outputType** *(default `jobs`)* — `jobs`, `companies` (deduplicated hiring-company leads), or `all`.
- **maxItems / maxItemsPerSource** — output cap, and how many to pull per board before filtering (raise it for narrow keyword searches).
- **includeDescriptionHtml** *(default false)* — also keep the raw HTML description.
- **deduplicateAcrossSources** *(default true)* — drop the same role when it appears on more than one board.
- **enrichCompanyContacts** *(default false)* — derive each company's website from the job links/apply URL and crawl it (home + contact/about) for emails, phone and socials, then assign a 0–100 lead score. Job boards never expose company emails — this is the only way to get them.
- **monitorMode / monitorKey** — output only jobs not seen in previous runs (see below).
### Output
By default you get **one clean, dense table of remote jobs** (`type: "job"`). Set `outputType` to `companies` for deduplicated hiring-company leads (`type: "company"`), or `all` for both.
A job record:
```json
{
"type": "job",
"source": "remotive",
"sourceLabel": "Remotive",
"id": "remotive:2090991",
"title": "Senior Python Engineer",
"company": "Quinncia Inc",
"companyLogo": "https://remotive.com/job/2090991/logo",
"url": "https://remotive.com/remote-jobs/software-development/senior-python-engineer-2090991",
"applyUrl": "https://remotive.com/remote-jobs/software-development/senior-python-engineer-2090991",
"category": "Software Development",
"categories": ["Software Development"],
"tags": ["python", "django", "graphql", "react", "aws"],
"jobType": "Full-time",
"seniority": "Senior",
"isRemote": true,
"candidateLocation": "USA",
"locationRestrictions": ["USA"],
"timezoneRestrictions": [-8, -7, -6, -5],
"salaryMin": 120000,
"salaryMax": 160000,
"salaryCurrency": "USD",
"salaryPeriod": "yearly",
"salaryLabel": "USD 120k–160k/year",
"description": "We are looking for a Senior Python Engineer to…",
"publishedAt": "2026-06-16T06:59:30.000Z",
"scrapedAt": "2026-06-17T12:00:00.000Z"
}
```
A company lead record (`type: "company"`) carries `company`, `companyLogo`, `jobCount`, the `sources` it posts on, `topTags`, `sampleJobTitles`, and — with `enrichCompanyContacts` — `website`, `domain`, `emails`, `phones`, `socialLinks` and a 0–100 `leadScore`.
#### What to expect (field coverage)
These are aggregated, organizer-entered listings, so some fields are present only when the company published them. A blank field means the source didn't provide it — nothing is dropped, so you always get the richest record available.
| Field group | Coverage |
|---|---|
| title, company, url, apply link, source, posting date | ~100% |
| skills/tags, category, candidate location | usually present |
| structured salary | when the board or salary text publishes it (strongest on Himalayas, Jobicy, RemoteOK, Remotive) |
| timezone restrictions, seniority | Himalayas / Jobicy |
| company emails & phone | with `enrichCompanyContacts`, when the company's website lists them |
### Monitor only new jobs
Turn on **monitorMode** and the actor remembers job ids across runs (in a named key-value store) and outputs **only jobs it hasn't seen before** — ideal for alerts and incremental syncs. It works **alongside** [Apify Schedules](https://docs.apify.com/platform/schedules): the schedule decides *when* to run, monitor mode decides *what's new*. Use a distinct `monitorKey` per saved search so separate monitors keep independent memory.
### Automate & schedule
Run this actor on autopilot and pull results into your own stack:
- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily to capture new remote jobs the moment they post; pair with monitor mode for clean new-only output.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });
const run = await client.actor('scrapesage/remote-jobs-scraper').call({
searchQueries: ['python'],
candidateLocation: ['USA'],
monitorMode: true,
monitorKey: 'python-usa',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} new remote jobs`);
```
### Integrate with any app
Connect the dataset to 5,000+ apps — no code required:
- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new jobs or company leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new jobs.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.
### Use with AI assistants (MCP)
The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find new remote Python jobs in the US over $120k and list the hiring companies' contacts" and let it run this scraper for you.
### More scrapers from scrapesage
Build a complete **jobs & hiring-intelligence stack**:
- **[Multi-ATS Job Scraper](https://apify.com/scrapesage/multi-ats-job-scraper)** — jobs from Greenhouse, Lever, Ashby, SmartRecruiters & Workday company boards.
- **[LinkedIn Jobs Scraper](https://apify.com/scrapesage/linkedin-jobs-scraper)** — LinkedIn job postings as hiring-intent signals.
- **[Seek Job Scraper](https://apify.com/scrapesage/seek-job-scraper)** — Australia & New Zealand jobs, salaries & company leads.
- **[BuiltIn Jobs Scraper](https://apify.com/scrapesage/builtin-jobs-scraper)** — US tech & startup jobs.
- **[Y Combinator Scraper](https://apify.com/scrapesage/ycombinator-scraper)** — YC startups and their open roles.
- **[GitHub Scraper](https://apify.com/scrapesage/github-scraper)** — developers and open-source projects (great for technical sourcing).
- **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones & socials from any list of company domains.
- **[Levels.fyi Scraper](https://apify.com/scrapesage/levels-fyi-scraper)** — tech salaries & compensation benchmarks.
### Tips
- **Narrow keyword searches**: raise `maxItemsPerSource` so each board returns enough candidates before filtering.
- **Company leads**: turn on `enrichCompanyContacts` and sort by `leadScore` to prioritize the companies with reachable contacts and the most open roles.
- **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) + `monitorMode` + `postedWithinDays` for a clean daily new-jobs feed.
- **Proxies**: the default Apify proxy works for all sources; switch to Residential if RemoteOK or WeWorkRemotely get rate-limited from datacenter IPs.
### FAQ
**Which job boards does it cover?** RemoteOK, Remotive, WeWorkRemotely, Himalayas, Jobicy, Arbeitnow and Working Nomads — all in a single run, de-duplicated into one dataset.
**Do I need API keys for the boards?** No. Every source is a public, keyless endpoint. No login or browser needed.
**Can I get only new jobs?** Yes — enable `monitorMode` and schedule the actor. It outputs only jobs not seen in previous runs.
**Where do company emails come from?** Never from the job boards (they don't publish them). With `enrichCompanyContacts` on, the actor finds the company's own website from the job's links and extracts publicly listed contact details — the same thing a human visitor would see.
**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).
**A field is empty — why?** Some listings don't publish a salary, timezone, or seniority. Fields are blank only when the source didn't provide them — never because the scraper skipped them.
**Is scraping these boards legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (e.g. GDPR/CCPA for personal data) and each source's terms.
### Need help?
Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.
# Actor input Schema
## `searchQueries` (type: `array`):
Keywords to match against job title, company, skills/tags and description (e.g. python, product manager, devops). A job matches if it contains ANY keyword. Leave empty to pull the latest remote jobs from every selected board.
## `sources` (type: `array`):
Which remote job boards to aggregate. Leave empty to use all 7. Options: remoteok, remotive, weworkremotely, himalayas, jobicy, arbeitnow, workingnomads.
## `categories` (type: `array`):
Optional category filter, matched against each job's category/industry and tags (e.g. software development, marketing, design, customer support, sales, data, devops, finance, hr, writing). A job matches if it contains ANY value.
## `candidateLocation` (type: `array`):
Filter by where candidates may be based, matched against the job's candidate-location restrictions (e.g. USA, Europe, United Kingdom, Worldwide, LATAM). Jobs open to Worldwide/Anywhere always pass.
## `companyNames` (type: `array`):
Optional: only keep jobs whose company name contains one of these values (case-insensitive). Handy for tracking specific employers.
## `jobType` (type: `string`):
Filter by employment type.
## `seniority` (type: `string`):
Optional seniority keyword, matched against the job's seniority field and title (e.g. senior, junior, lead, entry, manager).
## `salaryMin` (type: `integer`):
Only keep jobs whose published salary (upper bound) is at least this amount. Jobs without a published salary are dropped when this is set. Leave empty to include all.
## `postedWithinDays` (type: `integer`):
Only include jobs posted within this many days. Leave empty for no date limit. Great for daily monitoring runs (e.g. 1 or 3).
## `outputType` (type: `string`):
jobs = one row per remote job (default). companies = one deduplicated hiring-company lead per row. all = both, each row tagged with a type field.
## `maxItems` (type: `integer`):
Maximum number of job records to output (the cap is applied after filtering and de-duplication).
## `maxItemsPerSource` (type: `integer`):
How many jobs to fetch from each board before filtering. 0 = auto (scales to Max items). Raise it when using narrow keyword filters so enough candidates are gathered.
## `includeDescriptionHtml` (type: `boolean`):
Also include the original HTML description (descriptionHtml) alongside the clean plain-text description. Off by default for smaller, cleaner output.
## `deduplicateAcrossSources` (type: `boolean`):
Drop the same role when it appears on more than one board (matched by company + title), keeping the most recent. Turn off to see every board's copy.
## `enrichCompanyContacts` (type: `boolean`):
For each hiring company, derive its website from the job's links/apply URL and crawl it (home + contact/about, up to 3 pages) for contact emails, phone and social links, then assign a 0–100 lead score. Job boards never expose company emails — this is the only way to get them. Implies company-lead output.
## `monitorMode` (type: `boolean`):
Remember job ids across runs in a named key-value store and output ONLY jobs not seen before. Combine with an Apify Schedule (e.g. hourly/daily) for new-remote-job alerts. Works alongside Apify Schedules — it does not replace them.
## `monitorKey` (type: `string`):
Names the memory bucket for monitor mode. Use a distinct key per saved configuration (e.g. python-usa) so separate monitors don't share state.
## `maxConcurrency` (type: `integer`):
Parallel requests for company-contact enrichment.
## `proxyConfiguration` (type: `object`):
Proxy settings. The default Apify proxy works for all sources; switch to Residential if RemoteOK or WeWorkRemotely get rate-limited from datacenter IPs.
## Actor input object example
```json
{
"searchQueries": [
"python"
],
"jobType": "",
"outputType": "jobs",
"maxItems": 200,
"maxItemsPerSource": 0,
"includeDescriptionHtml": false,
"deduplicateAcrossSources": true,
"enrichCompanyContacts": false,
"monitorMode": false,
"monitorKey": "default",
"maxConcurrency": 5,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `results` (type: `string`):
All scraped remote job records and optional company lead records as JSON items in the default dataset.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchQueries": [
"python"
],
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/remote-jobs-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"searchQueries": ["python"],
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("scrapesage/remote-jobs-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"searchQueries": [
"python"
],
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call scrapesage/remote-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapesage/remote-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Remote Jobs Scraper - 7 Boards, Salaries & Leads",
"description": "Aggregate remote jobs from RemoteOK, Remotive, WeWorkRemotely, Himalayas, Jobicy, Arbeitnow & Working Nomads in one run: salary, skills, location, full description & apply link. Filter by keyword, salary & date. Company leads + monitoring for new jobs. JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "5pVSNj7jh8BARMHik"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~remote-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-remote-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapesage~remote-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-remote-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapesage~remote-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-remote-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchQueries": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to match against job title, company, skills/tags and description (e.g. python, product manager, devops). A job matches if it contains ANY keyword. Leave empty to pull the latest remote jobs from every selected board.",
"items": {
"type": "string"
}
},
"sources": {
"title": "Job boards (sources)",
"type": "array",
"description": "Which remote job boards to aggregate. Leave empty to use all 7. Options: remoteok, remotive, weworkremotely, himalayas, jobicy, arbeitnow, workingnomads.",
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Optional category filter, matched against each job's category/industry and tags (e.g. software development, marketing, design, customer support, sales, data, devops, finance, hr, writing). A job matches if it contains ANY value.",
"items": {
"type": "string"
}
},
"candidateLocation": {
"title": "Candidate location / region",
"type": "array",
"description": "Filter by where candidates may be based, matched against the job's candidate-location restrictions (e.g. USA, Europe, United Kingdom, Worldwide, LATAM). Jobs open to Worldwide/Anywhere always pass.",
"items": {
"type": "string"
}
},
"companyNames": {
"title": "Company names",
"type": "array",
"description": "Optional: only keep jobs whose company name contains one of these values (case-insensitive). Handy for tracking specific employers.",
"items": {
"type": "string"
}
},
"jobType": {
"title": "Job type",
"enum": [
"",
"full-time",
"part-time",
"contract",
"freelance",
"internship"
],
"type": "string",
"description": "Filter by employment type.",
"default": ""
},
"seniority": {
"title": "Seniority",
"type": "string",
"description": "Optional seniority keyword, matched against the job's seniority field and title (e.g. senior, junior, lead, entry, manager)."
},
"salaryMin": {
"title": "Minimum salary",
"minimum": 0,
"type": "integer",
"description": "Only keep jobs whose published salary (upper bound) is at least this amount. Jobs without a published salary are dropped when this is set. Leave empty to include all."
},
"postedWithinDays": {
"title": "Posted within (days)",
"minimum": 1,
"type": "integer",
"description": "Only include jobs posted within this many days. Leave empty for no date limit. Great for daily monitoring runs (e.g. 1 or 3)."
},
"outputType": {
"title": "Output type",
"enum": [
"jobs",
"companies",
"all"
],
"type": "string",
"description": "jobs = one row per remote job (default). companies = one deduplicated hiring-company lead per row. all = both, each row tagged with a type field.",
"default": "jobs"
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Maximum number of job records to output (the cap is applied after filtering and de-duplication).",
"default": 200
},
"maxItemsPerSource": {
"title": "Max items per source",
"minimum": 0,
"type": "integer",
"description": "How many jobs to fetch from each board before filtering. 0 = auto (scales to Max items). Raise it when using narrow keyword filters so enough candidates are gathered.",
"default": 0
},
"includeDescriptionHtml": {
"title": "Include raw HTML description",
"type": "boolean",
"description": "Also include the original HTML description (descriptionHtml) alongside the clean plain-text description. Off by default for smaller, cleaner output.",
"default": false
},
"deduplicateAcrossSources": {
"title": "Deduplicate across boards",
"type": "boolean",
"description": "Drop the same role when it appears on more than one board (matched by company + title), keeping the most recent. Turn off to see every board's copy.",
"default": true
},
"enrichCompanyContacts": {
"title": "Enrich company contacts (emails, phone, socials)",
"type": "boolean",
"description": "For each hiring company, derive its website from the job's links/apply URL and crawl it (home + contact/about, up to 3 pages) for contact emails, phone and social links, then assign a 0–100 lead score. Job boards never expose company emails — this is the only way to get them. Implies company-lead output.",
"default": false
},
"monitorMode": {
"title": "Monitor mode (only new jobs)",
"type": "boolean",
"description": "Remember job ids across runs in a named key-value store and output ONLY jobs not seen before. Combine with an Apify Schedule (e.g. hourly/daily) for new-remote-job alerts. Works alongside Apify Schedules — it does not replace them.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the memory bucket for monitor mode. Use a distinct key per saved configuration (e.g. python-usa) so separate monitors don't share state.",
"default": "default"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "Parallel requests for company-contact enrichment.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. The default Apify proxy works for all sources; switch to Residential if RemoteOK or WeWorkRemotely get rate-limited from datacenter IPs.",
"default": {
"useApifyProxy": true
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```