# RemoteOK Scraper (`automly/remoteok-scraper`) Actor

Scrape RemoteOK remote jobs by tag or keyword, location and date: title, company, salary range, tags, location, posted date, apply link and full description.

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

## Pricing

from $0.59 / 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.
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

## RemoteOK Scraper

### What is RemoteOK Scraper?

**RemoteOK Scraper** lets you **scrape remote jobs from RemoteOK** (remoteok.com), one of the best-known remote job boards: title, company, salary range, location, tags, posted date, apply link and the **full job description**. Type a tag or keyword like `python`, `react` or `marketing`, click **Start**, and download the jobs as Excel, CSV or JSON.

- 🏷️ **Search by RemoteOK tag:** the newest jobs for every tag you enter
- 💰 **Salary data:** minimum and maximum yearly salary when the job shows it
- 📅 **Date filter:** only jobs posted in the last day, 3, 7, 14 or 30 days
- 🌍 **Location filter:** only jobs open to candidates in your country or region
- 🔗 **Link to the original:** every job keeps its RemoteOK link
- 🔓 **No login:** no RemoteOK account needed

### What can RemoteOK Scraper do?

- **Scrape RemoteOK jobs by tag**, like `python`, `react`, `devops`, `design`, `marketing` or `customer-support`
- **Search with a phrase** like `data analyst`; when no tag matches, the newest jobs are searched for its words
- **Get the newest remote jobs** with no keyword at all
- **Keep only jobs open to a location**, like `United States` or `Europe` (jobs open worldwide are included)
- **Keep only recent jobs** with the date filter
- Export to Excel, CSV, JSON, HTML or XML, or send the data to Google Sheets, Make, Zapier and more

### What data can you extract from RemoteOK?

| | | |
|---|---|---|
| 💼 Job title, job ID and link | 🏢 Company and logo | 📍 Location |
| 🏷️ Tags | 💰 Salary min, max, currency | 📅 Posted date |
| 🔗 Apply link | 📝 Full description | 🌐 Board name for attribution |

### How to scrape RemoteOK jobs

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open **RemoteOK Scraper**.
3. Enter tags or keywords, one per line.
4. Pick the filters you want and the most jobs to save.
5. Click **Start**, then download the jobs as Excel, CSV, JSON or HTML.

### How much does it cost to scrape RemoteOK?

You pay only for the jobs you get: one price per job saved. See the **Pricing** tab for the price on your plan.

Every Apify account gets **$5 of free usage each month**, enough to try the scraper on real searches.

### ⬇️ Input

| Field | What it does |
|---|---|
| Search keywords (tags) | RemoteOK tags or words, one per line; each is its own search |
| Max jobs | Most jobs the whole run saves; several keywords share it evenly |
| Date posted | Only jobs posted in the last day, 3, 7, 14 or 30 days |
| Candidate location | Only jobs open to candidates in a country or region |

```json
{
    "keywords": ["python", "react"],
    "datePosted": "30",
    "maxResults": 200
}
```

### ⬆️ Output

```json
{
    "jobId": "1136795",
    "site": "remoteok.com",
    "url": "https://remoteOK.com/remote-jobs/remote-senior-software-engineer-case-execution-pivotal-health-1136795",
    "title": "Senior Software Engineer Case Execution",
    "companyName": "Pivotal Health",
    "location": "New York City",
    "tags": ["dev", "front end", "python", "design"],
    "salaryText": "USD 190,000 - 220,000 per year",
    "salaryMin": 190000,
    "salaryMax": 220000,
    "salaryCurrency": "USD",
    "salaryPeriod": "year",
    "postedAt": "2026-08-16T00:00:03Z",
    "applyUrl": "https://remoteOK.com/remote-jobs/remote-senior-software-engineer-case-execution-pivotal-health-1136795",
    "descriptionText": "About Pivotal Health\nPivotal Health is the leading technology platform ...",
    "source": "python",
    "scrapedAt": "2026-10-15T09:58:11Z"
}
```

Every row has the same fields in the same order as our other remote job scrapers; a field RemoteOK does not give is `null` or an empty list. Dates are ISO 8601 in UTC.

### Use cases

- **Remote job boards and newsletters:** the newest RemoteOK jobs for your niche every day
- **Job seekers:** fresh remote jobs for your stack in one sheet
- **Salary research:** remote pay by tag
- **Recruiters:** which companies are hiring remotely right now

### Tips

- **How many jobs:** RemoteOK gives the newest 100 jobs per tag; enter several tags to cover more.
- **Daily feed:** schedule a run with **Date posted: last 24 hours**.
- **Link back:** RemoteOK asks that you link to each job (`url`) and name Remote OK as the source when you show its jobs.

### Use with AI agents (MCP)

AI agents can run RemoteOK Scraper through the Apify MCP server. Ask for example "Get the newest remote React jobs from RemoteOK" and the agent starts the run with `{"keywords": ["react"], "maxResults": 100}`.

### FAQ

**How much does RemoteOK Scraper cost?**
You pay per job saved; the **Pricing** tab shows the price on your plan. Free accounts get $5 of usage every month.

**Do I need a RemoteOK account?**
No. The scraper reads only public job listings.

**Why do I get at most about 100 jobs per tag?**
That is how many recent jobs RemoteOK lists for a tag. Add more tags for more jobs.

**Is it legal to scrape RemoteOK?**
The scraper collects public job listings and removes emails and phone numbers from the text. Remote OK asks that you link back to each job and name it as the source; every row keeps the link. Check the rules that apply to how you use the data with your legal advisor. RemoteOK Scraper is not affiliated with or endorsed by Remote OK.

**Can I use it with the Apify API, Make, Zapier or n8n?**
Yes. Start runs and fetch results through the Apify API or any of the Apify integrations, and schedule runs to collect new jobs every day.

**Something does not work. What should I do?**
Open an issue on the **Issues** tab with your input, and we will look at it quickly.

### Related scrapers

| Scraper | What it gets |
|---|---|
| Remote Jobs Scraper | Himalayas, RemoteOK, We Work Remotely and Jobicy in one run |
| Himalayas Jobs Scraper | Every remote job on Himalayas, with country, seniority and salary filters |
| We Work Remotely Scraper | We Work Remotely jobs by keyword and category |

### Your feedback

If the scraper saves you time, a short review on the Store page helps others find it. Missing a field? Tell us on the **Issues** tab.

# Actor input Schema

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

RemoteOK tags or words to search for, one per line, e.g. "python", "react", "marketing" or "customer support". Each keyword is its own search. Leave empty for the newest jobs.

## `maxResults` (type: `integer`):

Most jobs the whole run saves, e.g. 100. Several keywords share it evenly.

## `datePosted` (type: `string`):

Only jobs posted in this period, e.g. last 7 days.

## `location` (type: `string`):

Only jobs open to candidates in this country or region, e.g. United States, United Kingdom, Germany or Europe. Jobs open worldwide are included. The job's stated location is checked.

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

The default works for most runs. If results come back empty, try a different proxy option.

## Actor input object example

```json
{
  "keywords": [
    "python"
  ],
  "maxResults": 50,
  "datePosted": "any",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

## `details` (type: `string`):

No description

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

No description

## `report` (type: `string`):

No description

# 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"
    ],
    "maxResults": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/remoteok-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"],
    "maxResults": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("automly/remoteok-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"
  ],
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call automly/remoteok-scraper --silent --output-dataset

```

## MCP server setup

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