# Remote Jobs Scraper - RemoteOK, We Work Remotely, Jobicy & More (`topapi/remote-jobs-scraper`) Actor

Scrape remote jobs from 11 boards in one deduplicated feed: Remote OK, We Work Remotely, Remotive, Jobicy, Working Nomads, Arbeitnow, Jobspresso, DevITjobs, The Muse, HN Who is hiring. Salary in USD, who can apply, apply links, monitor mode, company emails. $0.81 per 1,000 jobs.

- **URL**: https://apify.com/topapi/remote-jobs-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.81 / 1,000 jobs

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Remote Jobs Scraper do?

**Remote Jobs Scraper** collects remote and work-from-home jobs from 11 job boards in one run and returns them as one deduplicated list: [Remote OK](https://remoteok.com), [We Work Remotely](https://weworkremotely.com), [Remotive](https://remotive.com), [Jobicy](https://jobicy.com), [Working Nomads](https://www.workingnomads.com), [Arbeitnow](https://www.arbeitnow.com) (remote jobs), [Jobspresso](https://jobspresso.co), [DevITjobs US](https://devitjobs.us) and [UK](https://devitjobs.uk) (remote jobs), [The Muse](https://www.themuse.com) ("Flexible / Remote", opt-in) and the [Hacker News "Who is hiring?"](https://news.ycombinator.com/submitted?id=whoishiring) thread (remote posts). Every board's job comes out in the same row shape: title, company, who can apply from where, job type, seniority, salary (also in US dollars a year), dates, apply link and the full description. Job boards, newsletters, recruiters and job-market researchers use it to pull the remote job market into one sheet or one API call.

- 🌐 **11 boards in one run**, read to their full depth: the whole Remote OK board (about 1,050 jobs), every We Work Remotely category (about 530), all of Jobicy (about 1,300) and Working Nomads (about 5,300)
- 🔁 **One row per job**: the same company + title on several boards is merged into one row; the other boards are listed in `alsoFoundOn` and fill its empty fields (salary, website, the employer's own apply link)
- 🌍 **Who can apply**: `applicantCountries`, `remoteScope` (worldwide / restricted / unclear) and the posting's own sentence in `eligibilityEvidence`; filter by your country or region
- 💵 **Salary in one unit**: the board's own figure in `salary`, and `salaryUsdYearlyMin` / `salaryUsdYearlyMax` for filtering and comparing
- 🎯 **Filters before you pay**: keywords, companies, tags, country / region, job type, seniority, minimum salary, posting date, visa sponsorship, hybrid on/off
- 🔔 **Monitor mode** for schedules: only jobs you have not received, with Slack, Discord, Telegram or webhook alerts
- 📇 **Company contacts add-on**: emails and social profiles from the employer's own website
- 🔓 No login, no cookies, no API key

### What data can you get from remote job boards?

| | | |
|---|---|---|
| 💼 Job title, board, board job id, URLs | 🏢 Company, logo, website, own domain | 🔗 Apply link (the employer's ATS where the board gives it) |
| 🌍 Applicant countries and regions | 🧭 Remote scope + eligibility sentence | 🏠 Remote / hybrid |
| ⏱️ Job type (full-time, contract...) | 🎓 Seniority level | 🗂️ Categories, tags, skills, industry |
| 💵 Salary min / max, currency, unit | 💲 Salary in USD a year | 🛂 Visa sponsorship, relocation |
| 📅 Posted, valid through, age in days | 📝 Full description (text, HTML, Markdown) | ✉️ Emails and apply links in the posting |
| ✅ Remote OK verified mark, direct apply | ⭐ Featured listing | 🎁 Benefits, work hours |
| 🏭 Company size and type (DevITjobs) | 🔁 Also found on (other boards) | 🆕 New / updated / removed, first seen, reposts |
| ➕ Company contacts: emails, socials | ➕ Working Nomads company profile | 🧵 Hacker News author and thread |

### How to scrape remote jobs with Remote Jobs Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) (it comes with monthly free credit).
2. Open **Remote Jobs Scraper**. Leave **Job boards** empty to read all of them, or pick the ones you want.
3. Add **Keywords** such as `python developer` or `customer support`, and an **Applicant location** such as `Germany` or `Europe` if you need them.
4. Set **Max jobs** and click **Start**.
5. Download the jobs as JSON, CSV, Excel or HTML, or read them through the API.

### ⬇️ Input

Every field is optional. An empty form returns the 200 newest jobs, spread evenly across 10 boards (The Muse is opt-in).

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `sources` | multi-select | `remoteok`, `weworkremotely`, `remotive`, `jobicy`, `workingnomads`, `arbeitnow`, `jobspresso`, `devitjobs_us`, `devitjobs_uk`, `themuse`, `hackernews`. Empty = all but `themuse`. |
| `searchQueries` | list | Keywords, one per line, e.g. `python developer`. A job matches a line when every word is in its title, company, tags, categories or skills (whole words). Several lines = any of them. |
| `startUrls` | list | Board pages: a Remote OK tag page (`remoteok.com/remote-python-jobs`), a We Work Remotely category (`weworkremotely.com/categories/remote-design-jobs`), `workingnomads.com/jobs`, `jobicy.com`... Each adds its board (and its tag or category). |
| `remoteokTags` | list | Read only these Remote OK tags, e.g. `dev`, `design`, `customer support`. |
| `wwrCategories` | multi-select | Read only these We Work Remotely categories. |
| **🎯 Filters** (applied before charging) | | |
| `countries` | list | Countries or regions applicants may be in: `Germany`, `DE`, `US`, `Europe`, `EU`, `EMEA`, `LATAM`, `North America`, `APAC`. Worldwide jobs always pass; a job open to Europe passes for `DE`. |
| `includeUnclearEligibility` | boolean | With a location set, also keep jobs that name no location. Default off. |
| `worldwideOnly` | boolean | Only jobs open anywhere. |
| `jobTypes` | multi-select | `FULL_TIME`, `PART_TIME`, `CONTRACT`, `FREELANCE`, `INTERNSHIP`, `TEMPORARY`. |
| `seniority` | multi-select | `INTERN`, `ENTRY`, `JUNIOR`, `MID`, `SENIOR`, `LEAD`, `MANAGER`, `DIRECTOR`, `EXECUTIVE`. |
| `minSalary` | integer | USD per year (hourly, monthly and other currencies converted). Jobs without a salary are kept unless `salaryOnly`. |
| `salaryOnly` | boolean | Only jobs that publish a salary. |
| `postedWithinDays` / `postedAfter` | integer / date | Only jobs posted in the last N days / after a date. |
| `visaSponsorshipOnly` | boolean | Only jobs that offer visa sponsorship. |
| `includeHybrid` | boolean | Also keep hybrid jobs (Arbeitnow, DevITjobs, Jobspresso, Hacker News). Default off: fully remote only. |
| **✂️ Refine results** | | |
| `matchDescriptions` | boolean | Look for the keywords in the description too. |
| `excludeKeywords` | list | Skip jobs whose title or tags contain any of these. |
| `companies` / `excludeCompanies` | list | Only / never these companies (part of the name is enough). |
| `tagsFilter` | list | Only jobs with any of these tags, categories or skills. |
| `strictFilters` | boolean | Also skip jobs whose board does not state the field you filter on (type, seniority, salary, date). |
| `dedupe` | boolean | Merge the same company + title across boards (default on). |
| **➕ Extra data** | | |
| `enrichEmails` | boolean | Company contacts add-on (priced below). Default off. |
| `includeCompanyDetails` | boolean | Working Nomads company profile, free. Default off. |
| **🔁 Monitoring** | | |
| `monitorMode`, `monitorStoreName` | boolean, text | Deliver only jobs no earlier run with the same settings delivered. |
| `firstRunMode` | select | `emitAll` (deliver the current jobs) or `seedOnly` (remember them, deliver nothing, free). |
| `monitorIncludeUpdated`, `emitRemovedJobs`, `resetMonitor` | boolean | Re-deliver changed jobs; report jobs taken down; forget the memory. |
| `webhookUrl` (+ `webhookHeaders`, `webhookSecret`), `slackWebhookUrl`, `discordWebhookUrl`, `telegramToken` + `telegramChatId`, `notificationLimit` | text | Alerts with the new jobs after each run. |
| **📦 Output** | | |
| `maxItems` | integer | Jobs per run, default 200 (0 = every matching job). |
| `maxJobsPerSource` | integer | Cap per board. |
| `sortBy` | select | `balanced` (round-robin across boards, default) or `newest`. |
| `includeDescription`, `descriptionFormat`, `descriptionMaxLength` | boolean, select, integer | Full posting on/off; text + HTML (`html`, default), text + HTML + Markdown (`all`), text only (`text`), text + Markdown (`markdown`); a length cut. |
| `compact`, `excludeEmptyFields` | boolean | Core fields only (for AI / MCP); drop empty fields. |
| **⚙️ Advanced** | | |
| `maxPagesPerSource`, `jobicyGeo`, `jobicyIndustry`, `maxConcurrency`, `proxyConfiguration` | | Page cap per board; Jobicy's own region and industry filters; add-on concurrency; your own proxy. |

Input names used by other remote-job actors are accepted too (`platforms`, `boards`, `searchKeyword`, `searchTerms`, `keywords`, `eligibleFrom`, `regions`, `usOnly`, `timeFilter`, `maxTotalJobs`, `maxJobsPerPlatform`, `onlyNew`, `onlyNewJobs`, `monitorId`, `resetState`, `excludeHybrid`, `cleanHtml`, `emitExpired`...), so an existing API call keeps working.

#### Input JSON

```json
{
  "searchQueries": ["python", "react", "customer support"],
  "countries": ["Europe"],
  "jobTypes": ["FULL_TIME"],
  "postedWithinDays": 30,
  "maxItems": 150
}
```

#### How the boards are read

Each board is read through the feed it publishes for anyone: Remote OK's own job pages (50 jobs a page with the full posting), every We Work Remotely category feed (the main feed has only 100 jobs), Remotive's API and feed, Jobicy's API page by page, Working Nomads' search, Arbeitnow's API, Jobspresso's job listings API, DevITjobs' job files, The Muse's public API and Hacker News through Algolia. A single keyword is also sent to the boards that can search themselves (Remote OK, Working Nomads, Jobspresso, Hacker News), and every row is still checked against your words.

#### The same job on several boards

Employers post the same job on several boards. With **Merge the same job across boards** on, one company + title is one row: the copy with the most data is kept, `alsoFoundOn` lists the other boards with their links, and empty fields are filled from the other copies (a salary, the company website, the employer's own application link instead of a board's redirect). A 1,000-job run merged 46 copies; a run over every job of the 10 default boards merged 1,281 (8,317 rows from 9,598 matching postings).

### ⬆️ Output

One item per job. A real row from a test run (description shortened):

```json
{
  "type": "job",
  "source": "workingnomads",
  "sourceName": "Working Nomads",
  "sourceJobId": "1999915",
  "url": "https://www.workingnomads.com/jobs/senior-commercial-account-executive-acquisition-north-east-remote-grafana-labs",
  "applyUrl": "https://job-boards.greenhouse.io/grafanalabs/jobs/6187434004",
  "title": "Senior Commercial Account Executive, Acquisition | North East | Remote",
  "companyName": "Grafana Labs",
  "companyProfileUrl": "https://www.workingnomads.com/remote-company/grafana-labs",
  "location": "USA",
  "applicantCountries": ["United States"],
  "remoteScope": "restricted",
  "workArrangement": "remote",
  "employmentType": ["FULL_TIME"],
  "jobLevel": "SENIOR",
  "categories": ["Sales"],
  "tags": ["account executive", "salesforce", "leadership", "communication", "prospecting"],
  "salary": { "currency": "USD", "min": 200000, "max": 220000, "unit": "YEAR" },
  "salaryText": "$200k-$220k per year",
  "salaryUsdYearlyMin": 200000,
  "salaryUsdYearlyMax": 220000,
  "postedDate": "2026-11-05T23:10:48.298Z",
  "description": "Grafana Labs is the company behind Grafana Cloud, the fully managed observability platform …",
  "alsoFoundOn": [],
  "scrapedAt": "2026-11-06T04:52:32.895Z"
}
```

#### Fields

Filled share measured on a 1,000-job run over the 10 default boards (2026-11-06, about 117 jobs per board). The dataset's **Overview**, **Who can apply**, **Salaries**, **Companies** and **Monitor** views show the main columns.

| Field | What it is | Filled |
|---|---|---:|
| `source`, `sourceName`, `sourceJobId`, `url`, `applyUrl`, `title`, `companyName` | Board, the board's job id, job page, where to apply, title, company | 100% |
| `applyUrl` (employer's own) | The employer's ATS link where the board publishes it (Working Nomads, Jobspresso, DevITjobs); else the board's apply link | 100% (an ATS link on 3 boards) |
| `companyLogo`, `companyWebsite`, `companyDomain`, `companyProfileUrl` | Logo; website (We Work Remotely, Jobspresso, Hacker News); the employer's own domain (never an ATS or a board); company page on the board | 34%, 29%, 44%, 24% |
| `location` | Location as the board shows it | 100% |
| `applicantCountries` | Countries and regions applicants may be in | 73% |
| `remoteScope` | `worldwide` 15%, `restricted` 73%, `unclear` 12% | 100% |
| `eligibilityEvidence` | The posting's own sentence about where applicants must be | 6% |
| `workArrangement` | `remote` (hybrid only with Include hybrid jobs; The Muse "remote or onsite") | 100% |
| `employmentType` | FULL_TIME, PART_TIME, CONTRACT, FREELANCE, INTERNSHIP, TEMPORARY | 86% |
| `jobLevel` | Board level (Jobicy, Working Nomads, DevITjobs, The Muse), else from the title | 58% |
| `categories`, `tags`, `skills`, `industry` | Board categories, tags, skills / technologies, industry | 88%, 43%, 24%, 24% |
| `salary`, `salaryText`, `salaryUsdYearlyMin`, `salaryUsdYearlyMax` | Published salary {currency, min, max, unit}, as written, and in USD a year | 39% (DevITjobs 82-100%, Jobicy 59%, Working Nomads 44%, Remote OK 30%) |
| `postedDate`, `ageDays`, `validThrough` | Posted, days since, listing expiry (Remote OK, We Work Remotely) | 100%, 100%, 24% |
| `description`, `descriptionHtml`, `descriptionMarkdown` | Full posting (text, HTML; Markdown with that format) | 81% (every board but DevITjobs) |
| `contactEmails`, `applyLinks` | Emails and application links written in the posting | 11%, 17% |
| `visaSponsorship`, `relocationOffered` | true / false when the board or the posting says so, else null | 21%, 1% |
| `isVerified`, `directApply`, `jobBenefits`, `workHours` | Remote OK's verified mark and direct-apply flag, benefits, work hours | 12% (Remote OK rows) |
| `isFeatured` | Featured listing (Jobspresso, Working Nomads) | 24% |
| `companySize`, `companyType` | DevITjobs company size and type | 19% |
| `companyTagline`, `companySocials` | Jobspresso tagline; social profiles from the boards and the add-ons | 12%, 10% |
| `headquarters` | Company headquarters (We Work Remotely) | 11% |
| `hnAuthor`, `hnThread` | Hacker News poster and thread | 10% (Hacker News rows) |
| `alsoFoundOn` | Other boards (or other postings on the same board) carrying the same job: \[{source, sourceJobId, url}] | 3% on 1,000 jobs, 10% on every job of the 10 boards |
| `isNew`, `firstSeenAt`, `changeType` | Monitor mode: new / updated / removed / details (a job delivered before without the company contacts or company details a later run asks for, sent again with them) and first delivery | monitor runs |
| `isRepost`, `repostOfId`, `contentHash`, `matchedKeywords` | Same company + title re-posted under a new id; change hash; which keyword lines matched | as they apply |
| `companyDetails` | Working Nomads company profile (founded, hiring regions, about, benefits, remote policy, open roles) | Working Nomads rows with the option on |
| `contactEmail`, `contactWebsite`, `emailEnrichment` | Company contacts add-on: email, website read, all emails with their pages and social profiles | 11% of jobs on a 100-job run over every board, 34% over We Work Remotely, Working Nomads and Jobspresso |
| `removedAt` | Report jobs taken down: when the job was found gone | removed rows |
| `scrapedAt` | When the run read the job | 100% |

### How can I use remote jobs data?

- 📰 **Remote job boards and newsletters**: one scheduled run mirrors 11 boards into your site or newsletter, merged and in one schema.
- 🧲 **Recruiters and agencies**: every company hiring remotely for a skill or a region, with the employer's apply link and, with the add-on, its contact emails.
- 💼 **B2B sales**: a company hiring remote staff is buying tools and services; filter by job type, seniority and region to build target lists.
- 📊 **Market research**: remote salaries by role and region in one currency, who can apply from where, and posting volumes by board.
- 🧑‍💻 **Job seekers and alerts**: "remote Python jobs open to Germany, posted today" to Slack or Telegram every morning.
- 🤖 **AI agents**: compact rows through the API or MCP for job matching and market questions.

### How much does it cost to scrape remote jobs?

Remote Jobs Scraper is pay-per-result: **$0.81 per 1,000 jobs**, with the full description and every field in each row. No start fee. Jobs removed by your filters, copies merged into another row and jobs already delivered in monitor mode are never charged.

| Jobs | Price |
|---:|---:|
| 100 | $0.081 |
| 1,000 | $0.81 |
| 10,000 | $8.10 |

| Add-on | Price |
|---|---|
| Company contacts (`company-contacts`) | $0.0009 per job that got at least one email from the employer's website; nothing when no email is found |
| Working Nomads company profile | free |

Apify platform usage (compute, proxy) is included in these prices. Set a **maximum cost per run** in the run options and the run stops cleanly at it.

### Integrations, API, scheduling & MCP

- **Schedules:** run it hourly or daily from the **Schedules** tab; with **Only new jobs** each run returns only jobs you have not received, and a run with nothing new charges nothing.
- **Alerts:** Slack, Discord, Telegram or any webhook (with your headers or a secret), straight from the input.
- **No-code:** Make, Zapier, n8n, Google Sheets, Airtable, Notion via [Apify integrations](https://docs.apify.com/integrations).
- **API:** call it from Node.js or Python with `apify-client`; code on the [API tab](https://apify.com/topapi/remote-jobs-scraper/api/python) and the [Apify API reference](https://docs.apify.com/api/v2).
- **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/remote-jobs-scraper/api/mcp) and ask for remote jobs in plain language; **Compact rows** keeps the answers small.

### More TopApi scrapers

<table>
<tr>
<td>💼 <a href="https://apify.com/topapi/indeed-jobs-scraper">Indeed Jobs Scraper</a>: jobs from Indeed's country sites, remote filter included</td>
<td>🌴 <a href="https://apify.com/topapi/welcome-to-the-jungle-jobs-scraper">Welcome to the Jungle Jobs Scraper</a>: startup and tech jobs with remote policy</td>
<td>🇩🇪 <a href="https://apify.com/topapi/xing-jobs-scraper">XING Jobs Scraper</a>: jobs in Germany, Austria and Switzerland</td>
</tr>
<tr>
<td>🧭 <a href="https://apify.com/topapi">All TopApi actors</a></td>
<td></td>
<td></td>
</tr>
</table>

### Limits & empty runs

- **Board depth:** Remote OK about 1,050 jobs, We Work Remotely about 530 (all categories), Jobicy about 1,300, Working Nomads about 5,300, Jobspresso about 590, Arbeitnow about 350 remote jobs (of about 8,700), DevITjobs 240 + 70 remote jobs, Hacker News about 100 remote posts in the latest thread, Remotive 10-12 (all it publishes openly), The Muse about 6,000 "Flexible / Remote" jobs (opt-in; a run with keyword or other filters searches its newest ~2,000, the API's page limit).
- **Speed:** 50 jobs in about 3 seconds, 1,000 jobs in 6 seconds, every job on the 10 default boards (about 8,300) in 3.5-4.5 minutes, on the default 512 MB. A keyword search reads every board to the end, so `python` with 200 jobs takes about 10 seconds.
- **Descriptions:** DevITjobs shows its descriptions only inside its app, so its rows carry no `description` (title, company, salary, skills and apply link are there).
- **Salary:** 61% of jobs publish no salary; `salary` is `null` on those, never zero. Remote OK's "$80k - $155k" placeholder is not a salary and is dropped.
- **Not available:** We Work Remotely's featured / boosted marks (only on its web pages, which answer a browser check after one visit; its feeds do not carry them), Relomote (a browser check on every visit) and Himalayas (not included).
- **Empty dataset:** your filters removed every job (the status line says which filter removed how many), or in monitor mode nothing is new. Nothing is charged for an empty run.

### FAQ

#### How many remote jobs can Remote Jobs Scraper collect in one run?

Set **Max jobs** to `0` for every matching job: 8,317 unique jobs from the 10 default boards in our test (Working Nomads 4,454, Jobicy 1,171, Remote OK 1,040, We Work Remotely 465, Jobspresso 444, Arbeitnow 319, DevITjobs 318, Hacker News 96, Remotive 10), and about 3,200 more when you add The Muse. Remotive publishes only its newest 10-12 jobs to everyone, so it adds few.

#### Which boards does it read?

The 11 boards listed at the top; The Muse only when you add `themuse` to **Job boards** (its "Flexible / Remote" list mixes in office jobs, and its public API allows 500 calls an hour). Himalayas is not included. Relomote answers every request with a "Just a moment..." browser check, so it is not read.

#### Can I run Remote Jobs Scraper on a schedule to get only new jobs?

Yes. Turn on **Only new jobs (monitor mode)**, save the input as a task and add a schedule. Each run remembers the newest job it saw on every board and delivers only jobs posted after that and not delivered before. Use **First monitor run: remember the current jobs** to start from today without paying for the current list.

#### Does it return the full job description?

Yes, on every board except DevITjobs (it publishes no description outside its app): plain text and HTML by default, Markdown on request.

#### How is "who can apply" worked out?

From the board's own location data (Remote OK's applicant countries, We Work Remotely's region and country, Jobicy's region, Working Nomads' locations...), and when a board names no place, from a sentence in the posting such as "applicants must be physically located in the United States", which is quoted in `eligibilityEvidence`. `remoteScope` is `worldwide`, `restricted` or `unclear`.

#### How are salaries converted to US dollars a year?

Hourly x 2,080, daily x 260, weekly x 52, monthly x 12, and other currencies at fixed reference rates. The board's own figure and currency stay in `salary` and `salaryText`. Remote OK fills a placeholder "$80k - $155k" when the employer gives no salary; that placeholder is dropped, not delivered as a salary.

#### Can it get company contact details?

Yes, with **Company contacts**: the employer's own website (the one the board lists, or the employer's domain from the apply link, never an applicant-tracking system or a job board) is read on its home page and up to 3 contact / about pages for emails and social profiles. It is charged only when an email is found. Emails written in the posting itself are free in `contactEmails`.

#### Can I use Remote Jobs Scraper with the Apify API or an MCP server?

Yes. Start runs and read datasets with `apify-client` for [Node.js](https://apify.com/topapi/remote-jobs-scraper/api/javascript) or [Python](https://apify.com/topapi/remote-jobs-scraper/api/python), or connect an MCP client through the [MCP tab](https://apify.com/topapi/remote-jobs-scraper/api/mcp).

#### Do I need an account, cookies or an API key?

No. The actor reads what each board shows to every visitor.

#### Why did my run return no results?

Usually the filters: a keyword, a country and a salary floor together can remove every job. The status line says how many jobs were read and how many each filter removed. In monitor mode an empty run means nothing new since the last run. Nothing is charged for an empty run.

#### Is it legal to scrape remote job boards?

Remote Jobs Scraper reads only public job postings and does not log in. Remote OK, Remotive, Jobicy and Arbeitnow ask that their jobs link back to them and name them as the source; every row carries the board's `url` and `sourceName`. Postings can name people, and personal data is regulated (for example by GDPR), so make sure you have a legitimate purpose before you use it.

#### Your feedback

Found a bug or missing a board or a field? Open an issue on the [Issues tab](https://apify.com/topapi/remote-jobs-scraper/issues/open).

# Actor input Schema

## `sources` (type: `array`):

Boards to read. Empty = all except The Muse (add "themuse" to read it too). Remote OK, We Work Remotely, Remotive, Jobicy, Working Nomads and Jobspresso are remote-only boards; from Arbeitnow, DevITjobs, The Muse and Hacker News only the remote jobs are kept.

## `searchQueries` (type: `array`):

Job titles, skills or companies, one per line, e.g. "python developer", "customer support", "devops". A job matches a line when every word of it appears in the title, company, tags, categories or skills (whole words). Several lines = any of them. Empty = every job.

## `startUrls` (type: `array`):

Board pages to read, e.g. https://remoteok.com/remote-python-jobs (a Remote OK tag), https://weworkremotely.com/categories/remote-design-jobs (a We Work Remotely category), https://www.workingnomads.com/jobs, https://jobicy.com. Each URL adds its board (and its tag or category) to the run.

## `remoteokTags` (type: `array`):

Read only these Remote OK tags, one per line, e.g. "dev", "python", "design", "customer support", "marketing". Empty = Remote OK's whole board.

## `wwrCategories` (type: `array`):

Read only these We Work Remotely categories. Empty = every category.

## `countries` (type: `array`):

Countries or regions you can apply from, one per line: names ("Germany"), ISO codes ("DE", "US") or regions ("Europe", "EU", "EMEA", "LATAM", "North America", "APAC"). Worldwide jobs always pass; a job limited to Europe passes for "DE". Empty = no location filter.

## `includeUnclearEligibility` (type: `boolean`):

With an applicant location set: also keep jobs whose board states no location and whose posting names none (remoteScope "unclear"). Off = only jobs that name your location or are worldwide.

## `worldwideOnly` (type: `boolean`):

Only jobs open to applicants anywhere (remoteScope "worldwide").

## `jobTypes` (type: `array`):

Full-time, part-time, contract, freelance, internship or temporary. Several = any of them. Jobs whose board states no type are kept (see Strict filters).

## `seniority` (type: `array`):

From the board's own level where it has one (Jobicy, Working Nomads, DevITjobs, The Muse), else from the title. Several = any of them. Jobs with no level are kept (see Strict filters).

## `minSalary` (type: `integer`):

Keep jobs whose salary reaches this amount, in US dollars a year (hourly, monthly and other currencies are converted, see salaryUsdYearlyMax). Jobs with no published salary are kept unless "Only jobs with a salary" is on.

## `salaryOnly` (type: `boolean`):

Skip jobs that publish no salary.

## `postedWithinDays` (type: `integer`):

Only jobs posted in the last N days, e.g. 1, 7 or 30. 0 = any date.

## `postedAfter` (type: `string`):

Only jobs posted after this date (or ISO time, e.g. 2026-11-01T08:00:00Z).

## `visaSponsorshipOnly` (type: `boolean`):

Only jobs that offer visa sponsorship (DevITjobs' own field, or a posting that says it sponsors visas).

## `includeHybrid` (type: `boolean`):

Also keep hybrid jobs from boards that list them (Arbeitnow, DevITjobs, Jobspresso, Hacker News). Off = fully remote only.

## `matchDescriptions` (type: `boolean`):

Also look for the keywords in the full job description. Off = title, company, tags, categories and skills only.

## `excludeKeywords` (type: `array`):

Skip jobs whose title or tags contain any of these, e.g. "senior", "sales", "crypto".

## `companies` (type: `array`):

Only jobs from these companies (part of the name is enough), one per line.

## `excludeCompanies` (type: `array`):

Skip jobs from these companies (part of the name is enough).

## `tagsFilter` (type: `array`):

Only jobs carrying any of these tags, categories or skills, e.g. "react", "devops", "customer support".

## `strictFilters` (type: `boolean`):

When a job type, seniority, salary or date filter is set, also skip jobs whose board does not state that field. Off = keep them.

## `dedupe` (type: `boolean`):

One row per company + title: the copy with the most data is kept, the other boards' copies are listed in alsoFoundOn and fill its empty fields (salary, website, apply link...). Off = one row per posting per board.

## `enrichEmails` (type: `boolean`):

Visit the employer's own website (the one the board lists, or the employer's domain from the apply link; never an ATS or a job board) and add the emails and social profiles it publishes: contactEmail, contactWebsite, emailEnrichment. Charged per job only when at least one email is found.

## `includeCompanyDetails` (type: `boolean`):

For Working Nomads jobs, add the company's Working Nomads profile: website, founded year, hiring regions, about text, benefits, remote policy, open roles and social links (companyDetails). One extra page per company.

## `monitorMode` (type: `boolean`):

Remember every job delivered (in the named store below) and deliver only jobs not delivered by an earlier run with the same settings. A job reposted on another board is not new. A poll reads only each board's newest pages.

## `monitorStoreName` (type: `string`):

Named key-value store that keeps the memory. Use a different name per alert.

## `firstRunMode` (type: `string`):

What the first monitor run does: deliver the current jobs (up to Max jobs), or only remember them so the next run returns just new jobs.

## `monitorIncludeUpdated` (type: `boolean`):

Deliver a job again when its title, location, salary, apply link or description changed since it was delivered (changeType "updated").

## `emitRemovedJobs` (type: `boolean`):

Deliver a row (changeType "removed") for each remembered job that is no longer on its board. Each board is then read to its end on every run, so polls take longer.

## `resetMonitor` (type: `boolean`):

Forget the jobs remembered for these settings and start over.

## `webhookUrl` (type: `string`):

POST a JSON message with the new jobs (first N rows, count and dataset link) after each run that delivered jobs.

## `webhookHeaders` (type: `object`):

Extra headers for the webhook call, e.g. {"Authorization": "Bearer ..."}.

## `webhookSecret` (type: `string`):

Sent as the X-Webhook-Secret header so your endpoint can check the call.

## `slackWebhookUrl` (type: `string`):

Slack incoming-webhook URL for a message with the new jobs.

## `discordWebhookUrl` (type: `string`):

Discord webhook URL for a message with the new jobs.

## `telegramToken` (type: `string`):

Telegram bot token (with a chat id) for a message with the new jobs.

## `telegramChatId` (type: `string`):

Chat id the bot posts to.

## `notificationLimit` (type: `integer`):

How many jobs each alert lists.

## `maxItems` (type: `integer`):

Most jobs to deliver in this run (after filters and merging). 0 = every matching job on every board (about 8,300 from the 10 default boards with no filters, about 11,500 with The Muse).

## `maxJobsPerSource` (type: `integer`):

Most jobs from any one board. 0 = no limit.

## `sortBy` (type: `string`):

Balanced keeps every board in a capped run; newest-first fills the cap with the most recent jobs whichever board they came from.

## `includeDescription` (type: `boolean`):

The full job description. Off = compact metadata rows.

## `descriptionFormat` (type: `string`):

Which description fields to fill: description (text) is always there; descriptionHtml and descriptionMarkdown on request.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

## `compact` (type: `boolean`):

Only the core fields (board, ids, links, title, company, location, scope, type, level, salary, date).

## `excludeEmptyFields` (type: `boolean`):

Leave out fields that are empty on a row.

## `maxPagesPerSource` (type: `integer`):

Most feed pages read from any one board. Empty = as many as the run needs.

## `jobicyGeo` (type: `string`):

Jobicy's own region filter (its API geo parameter), e.g. "usa", "canada", "emea", "latam", "apac", "germany". Empty = all.

## `jobicyIndustry` (type: `string`):

Jobicy's own industry filter (its API industry parameter), e.g. "dev", "marketing", "supporting", "design-multimedia", "data-science". Empty = all.

## `maxConcurrency` (type: `integer`):

Parallel requests for the add-ons (company websites, company profiles). Boards are always read in parallel.

## `proxyConfiguration` (type: `object`):

Every board is read on direct egress first; if a board refuses, the run moves that board to the Apify datacenter proxy, then to residential. Set your own proxy here to read through it instead.

## Actor input object example

```json
{
  "includeUnclearEligibility": false,
  "worldwideOnly": false,
  "minSalary": 0,
  "salaryOnly": false,
  "postedWithinDays": 0,
  "visaSponsorshipOnly": false,
  "includeHybrid": false,
  "matchDescriptions": false,
  "strictFilters": false,
  "dedupe": true,
  "enrichEmails": false,
  "includeCompanyDetails": false,
  "monitorMode": false,
  "monitorStoreName": "remote-jobs-monitor",
  "firstRunMode": "emitAll",
  "monitorIncludeUpdated": false,
  "emitRemovedJobs": false,
  "resetMonitor": false,
  "notificationLimit": 10,
  "maxItems": 50,
  "sortBy": "balanced",
  "includeDescription": true,
  "descriptionFormat": "html",
  "descriptionMaxLength": 0,
  "compact": false,
  "excludeEmptyFields": false,
  "maxConcurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per remote job, merged across boards: title, company, applicant countries, remote scope, type, level, salary, dates, description, apply link.

## `summary` (type: `string`):

Per-board counts (read, matched, delivered, filtered, pages, egress), merged copies, filters and charges.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 50 }

# Run the Actor and wait for it to finish
run = client.actor("topapi/remote-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 50
}' |
apify call topapi/remote-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/remote-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/11xARDFrgt3H39zOn/builds/qjPAOoTjGQd0TDSWb/openapi.json
