# Remote Jobs Scraper (`properscraper/remote-jobs-scraper`) Actor

Collect remote job listings from Himalayas, Remote OK, Jobicy and Arbeitnow in one format: title, company, location, salary, tags, description and apply link. Filter by keyword and date. Uses each board's official public API.

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

## Pricing

from $0.50 / 1,000 job saveds

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

## Remote Jobs Scraper

Collect remote job listings from four job boards in one clean format: **Himalayas**, **Remote OK**, **Jobicy** and **Arbeitnow**. For each job you get the title, company, location limits, salary where given, job type, seniority, categories, tags, the full description as plain text, the posting date and the link to apply.

It uses each board's official public API, so results are complete and stable, and no login or API key is needed. Himalayas alone lists more than 100,000 open remote jobs.

Use it to:

- build or feed a job alert, newsletter or internal talent dashboard
- track who is hiring for a skill, and at what salary
- find companies that hire remotely in your market, as sales or recruiting leads
- research demand for roles and technologies over time by running it on a schedule

### Input

Every field is optional. With no input you get the 100 newest jobs from each board.

| Field | What it does |
|---|---|
| **Keywords** | One per line, such as `python` or `product manager`. Each keyword is searched on each board. Leave empty for the newest jobs of every kind. |
| **Job boards** | Which boards to read. Leave empty for all four. |
| **Jobs per search** | The most jobs saved for each keyword on each board. Default 100. |
| **Posted within days** | Only jobs posted in the last this many days. 0 means any date. |
| **Include the job description** | On by default. Turn off for a smaller, faster export. |

```json
{
    "keywords": ["python", "customer support"],
    "sources": ["himalayas", "remoteok", "jobicy"],
    "maxJobsPerSearch": 200,
    "postedWithinDays": 14
}
```

### Output

One record per job:

```json
{
    "source": "Himalayas",
    "search": "python",
    "id": "https://himalayas.app/companies/acme/jobs/senior-python-engineer",
    "title": "Senior Python Engineer",
    "company": "Acme",
    "companyLogo": "https://cdn-images.himalayas.app/abc123",
    "location": "United Kingdom, Ireland",
    "employmentType": "Full Time",
    "seniority": "Senior",
    "categories": ["Backend Engineer", "Python Developer"],
    "tags": ["Engineering"],
    "salaryMin": 90000,
    "salaryMax": 120000,
    "salaryCurrency": "USD",
    "salaryPeriod": "annual",
    "url": "https://himalayas.app/companies/acme/jobs/senior-python-engineer",
    "applyUrl": "https://himalayas.app/companies/acme/jobs/senior-python-engineer?utm_source=api",
    "postedAt": "2026-11-17T09:01:26.000Z",
    "expiresAt": "2027-01-16T09:01:26.000Z",
    "description": "About the role\nBuild and run the services behind…",
    "scrapedAt": "2026-11-18T12:00:00.000Z"
}
```

- `source` is the job board and `url` is the job's page there. `search` is the keyword that found it, or `null`.
- `location` is where applicants must be based. `Worldwide` means the board gives no limit.
- Salary fields are filled only when the board publishes a salary; most listings do not. Remote OK's figures are US dollars a year.
- `seniority`, `employmentType`, `categories` and `expiresAt` are filled where the board has them and are `null` or empty otherwise.
- A job found under two keywords is saved once.

A `SUMMARY` record in the run's key-value store lists how many jobs each search saved and any search that failed.

### Pricing

Pay per result. You are charged once for each job saved to the dataset, at the per-result price shown on this page. Jobs that do not match your keywords or date filter are not saved and cost nothing. The run stops as soon as it reaches the maximum charge you set for it.

### The job boards' terms

The boards offer these APIs free so their jobs are shared further, and they ask for much the same in return. If you publish the jobs anywhere:

- name the job board as the source and link to the job's page on it (`source` and `url` in every record), with a normal link
- send applicants to the board's own address for the job (`applyUrl`)
- do not pass the jobs on to other job aggregators such as Google Jobs, LinkedIn Jobs or Jooble
- do not use a board's logo without its permission

### Limits

- Himalayas and Jobicy search for the keyword themselves. Remote OK and Arbeitnow have no search, so there the keyword is matched against each job's title, company and tags.
- Remote OK's API returns its latest 100 or so jobs. Arbeitnow lists mostly on-site jobs in Germany; only the ones it marks remote are saved, from its newest 6,000 listings.
- Requests to each board are spaced two seconds apart, so a search for thousands of jobs takes a few minutes.
- Listings are the boards' own and may be in any language.

### Is this allowed?

The Actor reads only the public APIs these job boards publish for this purpose, at a modest rate, and never works around a limit.

# Actor input Schema

## `keywords` (type: `array`):

One per line, for example: python, product manager, customer support. Each keyword is searched on each job board. Leave empty to get the newest jobs of every kind.

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

Which job boards to read. Leave empty for all of them.

## `maxJobsPerSearch` (type: `integer`):

The most jobs saved for each keyword on each job board.

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

Only jobs posted in the last this many days. 0 means any date.

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

Save the full description as plain text. Turn off for a smaller, faster export.

## Actor input object example

```json
{
  "keywords": [
    "python",
    "marketing"
  ],
  "maxJobsPerSearch": 100,
  "postedWithinDays": 0,
  "includeDescription": true
}
```

# Actor output Schema

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

Every job saved by the run, one record per job.

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

Totals for the run and, for each job board and keyword, how many results were saved and any error.

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

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

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

```

## MCP server setup

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