# Remote Jobs Scraper: RemoteOK, Jobicy & Arbeitnow (`datasmithlab/remote-jobs-scraper`) Actor

Three remote job boards in one run: Remote OK, Jobicy and Arbeitnow, with cross-source duplicates removed, via their official public APIs. Keyword, location, salary and date filters, full descriptions, new-jobs-only monitoring.

- **URL**: https://apify.com/datasmithlab/remote-jobs-scraper.md
- **Developed by:** [Datasmithlab](https://apify.com/datasmithlab) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Remote Jobs Scraper: Remote OK, Jobicy & Arbeitnow

Export remote jobs from **three job boards in one run**: [Remote OK](https://remoteok.com), [Jobicy](https://jobicy.com) and [Arbeitnow](https://www.arbeitnow.com). One clean format, filters by keyword, location, salary and date, full descriptions, and a new-jobs-only mode for daily job alerts.

All data comes from each site's **official public API**. No login, no proxies, no browser.

### What you get

- **One format for three sources.** Title, company, location, remote flag, employment types, tags, seniority, salary (min, max, currency, period, yearly-equivalent), publish date, full description (HTML and plain text), job URL.
- **Cross-source duplicates removed.** The same job posted on two boards is returned once (matched on company + title).
- **Filters the APIs do not offer:** keywords, locations, posted within (24 hours to 30 days), minimum yearly salary and currency, exclude words in the title.
- **Only new jobs.** Turn on *Only new jobs since last run* and schedule the Actor daily. Each run returns only jobs you have not seen with the same settings.
- **Arbeitnow extras:** remote-only (default on, the board also lists on-site jobs) and a visa sponsorship filter.
- **Health and search reports** in the run's key-value store (`HEALTH`, `SEARCHES`): failed searches, capped searches, empty-field ratios.

### Input

| Field | What it does |
|---|---|
| Sources | Remote OK, Jobicy, Arbeitnow. Empty = all three |
| Search keywords | Match as whole words in title, tags, company or description. Empty = everything |
| Locations | Substring match on the location text (e.g. `Germany`, `USA`, `Europe`) |
| Include worldwide jobs | With Locations set, also keep "anywhere" jobs (default on) |
| Arbeitnow: remote jobs only / visa sponsorship | See above |
| Posted within | Any time, 24h, 3d, 7d, 14d, 30d |
| Minimum yearly salary + currency | Salary is the top of the range, converted to yearly (monthly x12, weekly x52, hourly x2080) |
| Exclude words in title | Whole-word match |
| Only new jobs since last run | Daily alerts |
| Include descriptions | Turn off for a lighter dataset |
| Max jobs | Stops after this many jobs. The limit is shared between the selected sources first, so a low limit still returns jobs from each one; leftover room goes to sources that have more |

### Output example

```json
{
  "id": "jobicy:154706",
  "source": "Jobicy (jobicy.com)",
  "title": "CRM Marketing Intern",
  "company": "Catawiki",
  "location": "Netherlands",
  "isRemote": true,
  "employmentTypes": ["Internship"],
  "seniority": "Entry-Level, Junior",
  "salaryMin": 600, "salaryMax": 600, "salaryCurrency": "EUR", "salaryPeriod": "monthly",
  "salaryYearlyMax": 7200,
  "publishedAt": "2026-10-06T13:16:32Z",
  "url": "https://jobicy.com/jobs/154706-crm-marketing-intern",
  "applyUrl": "https://jobicy.com/jobs/154706-crm-marketing-intern"
}
```

### Good to know

- **Depth per source.** Remote OK's API returns its most recent ~100 jobs (it offers no paging). Jobicy is read up to 3,000 jobs, Arbeitnow up to 40 pages (about 12,000 jobs). If a read is cut off, the search report says `capped`.
- **Keywords.** Remote OK and Arbeitnow jobs are matched on whole words in the title, tags, company and description. Jobicy runs the keyword through its own search, so its matching can differ slightly.
- **Locations.** A job with no location text (common on Remote OK) is treated as open worldwide.
- **Salaries.** Only Remote OK (yearly, assumed USD) and Jobicy publish salary ranges. Arbeitnow does not, so salary filters drop its jobs.
- **Attribution.** Each job carries `source` and `url` pointing to the original posting on the source site. Please credit the source and link to the original job when you republish the data, as the three sites ask in their API terms. `applyUrl` is the original posting, never a rewritten link.
- **Personal data.** The Actor returns job and company data only. It does not collect recruiter names, emails or phone numbers.
- **Scheduling.** The sources update hourly. Daily or hourly schedules with *Only new jobs* work well.

### Pricing

Pay per result plus a small start fee per run. You are charged only for jobs returned.

### Feedback

Missing a field or a source? Open an issue on this Actor's page. We read every one and reply.

# Actor input Schema

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

Which job boards to read. Leave empty for all three.

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

One keyword per line, e.g. 'python' or 'product designer'. A job matches if any keyword appears as a whole word in its title, tags, company or description. Leave empty to export everything.

## `locations` (type: `array`):

Keep jobs whose location text contains one of these (e.g. Germany, USA, Europe). Worldwide jobs are kept unless you turn that off below.

## `includeWorldwide` (type: `boolean`):

With Locations set: also keep jobs open to candidates anywhere.

## `arbeitnowOnlyRemote` (type: `boolean`):

Arbeitnow also lists on-site jobs. Keep this on to return only jobs it marks as remote.

## `visaSponsorship` (type: `boolean`):

Only Arbeitnow jobs that offer visa sponsorship.

## `postedWithin` (type: `string`):

Only jobs published in this window.

## `minYearlySalary` (type: `integer`):

Keep jobs whose salary (top of the range, converted to yearly) is at least this amount. Only Remote OK (USD) and Jobicy publish salaries; jobs without one are dropped when this is set.

## `salaryCurrency` (type: `string`):

Only jobs paying in this currency (jobs without a salary are dropped when set).

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

Drop jobs whose title contains any of these words (whole-word match).

## `onlyNewSinceLastRun` (type: `boolean`):

Return only jobs not seen in a previous run with the same settings. Schedule the Actor daily for job alerts.

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

Full job description as HTML and plain text.

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

Stop after this many jobs (you are charged per job returned).

## Actor input object example

```json
{
  "searchQueries": [
    "python"
  ],
  "includeWorldwide": true,
  "arbeitnowOnlyRemote": true,
  "visaSponsorship": false,
  "postedWithin": "any",
  "onlyNewSinceLastRun": false,
  "includeDescription": true,
  "maxItems": 100
}
```

# Actor output Schema

## `jobs` (type: `string`):

Job listings (table view, JSON/CSV/Excel export).

## `allFields` (type: `string`):

Every field of every job, including descriptions.

## `searches` (type: `string`):

For each source/keyword search: pages read, jobs seen, jobs matched, status.

## `health` (type: `string`):

Empty-field ratios, failed searches, duplicates dropped.

# 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 = {
    "searchQueries": [
        "python"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("datasmithlab/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 = { "searchQueries": ["python"] }

# Run the Actor and wait for it to finish
run = client.actor("datasmithlab/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 '{
  "searchQueries": [
    "python"
  ]
}' |
apify call datasmithlab/remote-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datasmithlab/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/6dvMhaZH5DBggcUPw/builds/H1CfU0zEv3rURAZjP/openapi.json