# RemoteOK Jobs Scraper (`devilscrapes/remoteok-jobs-scraper`) Actor

Pull the full RemoteOK remote-jobs feed in one call and filter it by tags, keywords, company, or minimum salary. Returns typed rows — position, company, tags, salary range, plain-text description, apply URL, posted date. No pagination or auth needed.

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

## Pricing

from $1.50 / 1,000 results

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

<div align="center">
  <img src=".actor/icon.svg" width="160" alt="Devil Scrapes mark" />

## RemoteOK Jobs Scraper

**$1.50 / 1 000 results**  ·  pay only for results  ·  no credit card to try

*We do the dirty work so your dataset stays clean.* 😈

Built for recruiters, job-board aggregators, and SDR teams: pull the full RemoteOK remote-jobs feed in one call and filter it by tags, keywords, company, or minimum salary. Returns typed rows — position, company, tags, salary range, plain-text description, apply URL, posted date. Export straight to JSON, CSV, or Excel.

</div>

***

### 🎯 What this scrapes

RemoteOK (remoteok.com) publishes its entire current remote-jobs feed as
a single public JSON array. This Actor fetches that feed, drops the feed
metadata, filters the postings client-side by tags, keywords, company
name, and/or minimum salary, cleans each HTML job description down to
plain text, and lands one typed dataset row per matching job — no
pagination, no login, no per-job page visits required.

### 🔥 Features

- 🛡️ **We rotate browser fingerprints** — `curl-cffi` impersonation replays real Chrome / Firefox TLS handshakes on every request, so the target sees a browser, not a script.
- 🔁 **We retry with exponential backoff** on `408 / 429 / 5xx` — up to 5 attempts, honouring `Retry-After` whenever the target sends it.
- 🧱 **We fail loud, not silent** — a broken upstream feed surfaces as a failed run with a clear status message, never a quiet empty dataset.
- 🧊 **We keep the dataset clean** — Pydantic-validated typed rows, HTML stripped to plain text, salary/logo fields null-normalized instead of guessed.
- 💰 **You pay only for results that land** — Pay-Per-Event pricing. No data, no charge.

### 💡 Use cases

- Recruiter tooling — pull today's remote-friendly openings for a given tech stack.
- Job-board aggregators — mirror RemoteOK's feed into your own listings without hand-rolling the parser.
- SDR / lead-gen — find companies actively hiring for roles that signal budget or growth.
- Market research — track which tags/skills are trending in remote job postings over time.

### ⚙️ How to use it

1. Click **Try for free** at the top of the page.
2. Optionally set `tags`, `keywords`, `company`, or `minSalary` to narrow the feed — leave everything blank to pull the whole current feed (capped by `maxItems`).
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API.

#### Call it from Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("DevilScrapes/remoteok-jobs-scraper").call(
    run_input={
        "tags": ["python", "remote"],
        "keywords": [],
        "company": "",
        "minSalary": 60000,
        "maxItems": 100,
        "proxyConfiguration": {"useApifyProxy": False},
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["position"], item["company"])
```

### 📥 Input

| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `tags` | `array` | no | `[]` | Keep jobs whose tags include ANY of these (case-insensitive). |
| `keywords` | `array` | no | `[]` | Keep jobs whose position/description/company contains ANY keyword (case-insensitive substring). |
| `company` | `string` | no | `""` | Case-insensitive substring match on company name. |
| `minSalary` | `integer` | no | — | Keep jobs where the listed maximum salary is at least this amount. |
| `maxItems` | `integer` | no | `100` | Cap on rows emitted, applied after filtering (1-1000). |
| `proxyConfiguration` | `object` | no | `{"useApifyProxy": false}` | Standard Apify Proxy config — optional for this public feed. |

#### Example input

```json
{
  "tags": ["python", "remote"],
  "keywords": [],
  "company": "",
  "minSalary": 60000,
  "maxItems": 100,
  "proxyConfiguration": { "useApifyProxy": false }
}
```

### 📤 Output

Every row is one dataset item.

| Field | Type | Notes |
|---|---|---|
| `job_id` | `string` | RemoteOK job ID (falls back to `slug` if missing). |
| `slug` | `string` | RemoteOK URL slug. |
| `position` | `string` | Job title. |
| `company` | `string` | Hiring company name. |
| `company_url` | `string \| null` | Not published by the live API today — always `null`, kept for forward-compat. |
| `location` | `string \| null` | Free-text location, `null` when empty. |
| `tags` | `array` | Tags/skills on the posting. |
| `salary_min` | `integer \| null` | `null` when RemoteOK reports no data. |
| `salary_max` | `integer \| null` | `null` when RemoteOK reports no data. |
| `description` | `string` | HTML stripped to clean plain text. |
| `apply_url` | `string` | Direct application URL. |
| `url` | `string` | RemoteOK job page URL. |
| `date_posted` | `string` | ISO-8601 timestamp. |
| `epoch_posted` | `integer` | Unix epoch seconds. |
| `logo` | `string \| null` | Company logo URL when available. |

#### Example output

```json
{
  "job_id": "1135478",
  "slug": "remote-entry-level-junior-trader-atom-partners-1135478",
  "position": "Entry Level Junior Trader",
  "company": "Atom Partners",
  "company_url": null,
  "location": null,
  "tags": ["other", "finance"],
  "salary_min": 50000,
  "salary_max": 60000,
  "description": "ATOM Partners is an international company focused on digital asset markets...",
  "apply_url": "https://remoteOK.com/remote-jobs/remote-entry-level-junior-trader-atom-partners-1135478",
  "url": "https://remoteOK.com/remote-jobs/remote-entry-level-junior-trader-atom-partners-1135478",
  "date_posted": "2026-07-27T12:50:24+00:00",
  "epoch_posted": 1785156624,
  "logo": null
}
```

### 💰 Pricing

Pay-Per-Event — you pay only when these events fire:

| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.02 | One-off warm-up charge per run |
| `result` | $0.0015 | Per dataset item (→ $1.50 / 1 000 results) |

Example: 1,000 results at the rates above ≈ **$1.50**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.

### 🚧 Limitations

RemoteOK's public feed only exposes its *current* live listings — there's
no historical archive and no pagination cursor, so this Actor returns a
single snapshot per run. Salary and logo data are sparse in practice
(most postings ship without them); we surface that as `null` rather than
guessing.

### ❓ FAQ

**Is this legal?**

We only fetch content the source makes publicly available via its own
documented feed. Respect RemoteOK's terms of service before using output
commercially.

**How do I export to Sheets?**

After the run, click *Storage → Dataset → Export* and pick CSV. Google
Sheets imports it directly.

**Why don't I see salary or logo data on most rows?**

RemoteOK's feed itself only populates those fields on a minority of
postings — we pass through exactly what the source reports, as `null`
when it's missing.

### 💬 Your feedback

Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship fixes
weekly and we read every report.

***

<div align="center">

Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.

</div>

# Actor input Schema

## `tags` (type: `array`):

Keep jobs whose tags include ANY of these (case-insensitive). Leave empty to skip this filter.

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

Keep jobs whose position, description, or company contains ANY of these keywords (case-insensitive substring match). Leave empty to skip this filter.

## `company` (type: `string`):

Keep jobs whose company name contains this text (case-insensitive substring match). Leave blank to skip this filter.

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

Keep jobs whose maximum listed salary is at least this amount. Jobs with no salary data are excluded when this filter is set. Leave blank to skip this filter.

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

Cap the number of rows emitted, applied after all filters.

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

Apify Proxy configuration. Optional for this Actor — enable it if you want every request routed through Apify Proxy for IP diversity or compliance reasons.

## Actor input object example

```json
{
  "tags": [
    "python",
    "remote"
  ],
  "keywords": [],
  "company": "",
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `datasetItems` (type: `string`):

All dataset items as JSON.

## `datasetItemsCsv` (type: `string`):

Same data exported to CSV.

## `datasetView` (type: `string`):

Open the run dataset in the Console.

# 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 = {
    "tags": [
        "python",
        "remote"
    ],
    "keywords": [],
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/remoteok-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 = {
    "tags": [
        "python",
        "remote",
    ],
    "keywords": [],
    "maxItems": 100,
    "proxyConfiguration": { "useApifyProxy": False },
}

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=devilscrapes/remoteok-jobs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/QJLxfcWJZUdRfYj7t/builds/nPoPM5fTaAsISoxmB/openapi.json