# RemoteOK Scraper: Remote Jobs, Salary & Tags (`themineworks/remoteok-jobs-scraper`) Actor

Scrape live remote job listings from RemoteOK — title, company, salary range, tags, location and apply link. Filter by keyword or tag. No login, no API key, pay per job. Use it as an MCP server in Claude, ChatGPT & AI agents.

- **URL**: https://apify.com/themineworks/remoteok-jobs-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Jobs, Lead generation, MCP servers
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 job scrapeds

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/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

## RemoteOK Scraper: Remote Jobs, Salary & Tags

Scrape live remote job listings from RemoteOK — title, company, salary range, tags, location and apply link. Filter by keyword or tag. No login, no API key, pay per job. Use it as an MCP server in Claude, ChatGPT & AI agents.

> ⚡ Part of a 74-scraper suite with 8,800+ runs · no login, no cookies, no ban risk.
>
> 💸 You are only charged for delivered results — empty searches, failed pages and duplicates are never billed.

### What it does

RemoteOK publishes its entire live board as a single public JSON feed. That makes this the
cheapest actor in the collection to run — one HTTP request, filtered client side, with no browser
and no proxy pressure.

Each record carries the job id, title, company, location, a tags array, salary range where
disclosed, the posting timestamp, a cleaned plain-text description, the apply URL and the company
logo. Two source-data problems are repaired on the way through, which is the main reason to use
this rather than reading the feed yourself.

### Input

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `keyword` | string | no | `"python"` | Filter jobs whose title, company or tags contain this keyword. |
| `tags` | array | no | `[]` | Only return jobs carrying at least one of these RemoteOK tags, e.g. 'engineer'. |
| `maxJobs` | integer | no | `10` | Maximum jobs to return. |

#### Example input

```json
{
  "keyword": "python",
  "tags": [],
  "maxJobs": 10
}
```

### Output

One record per job. Field list and example below are taken from a real run, not a mock-up.

| Field | Type | Example |
|---|---|---|
| `job_id` | string | `"1135437"` |
| `title` | string | `"General Shop"` |
| `company` | string | `"HEICO"` |
| `location` | string | `"Los Angeles, "` |
| `tags` | array | `[]` |
| `posted_at` | string | `"2026-07-26T09:33:11+00:00"` |
| `description` | string | `"POSITION: GENERAL SHOP LOCATION: Chatswort…` |
| `apply_url` | string | `"https://remoteOK.com/remote-jobs/remote-ge…` |
| `url` | string | `"https://remoteOK.com/remote-jobs/remote-ge…` |
| `scraped_at` | string | `"2026-07-27T10:37:21.001Z"` |

#### Example output

```json
{
  "job_id": "1135437",
  "title": "General Shop",
  "company": "HEICO",
  "location": "Los Angeles, ",
  "tags": [],
  "posted_at": "2026-07-26T09:33:11+00:00",
  "description": "POSITION: GENERAL SHOP LOCATION: Chatsworth, California SHIFT: 6:15am - 4:45pm (Monday thru Thursday). Please mention the word **PHENOMENAL** and tag RMjMuOTQuMTYyLjE2OA== when applying to show you read the job post completely (#RMjMuOTQuMTYyLjE2OA==). This is a beta feature to avoid spam applicants. Companies can search these words to find applicants that read this and see they're human.",
  "apply_url": "https://remoteOK.com/remote-jobs/remote-general-shop-heico-1135437",
  "url": "https://remoteOK.com/remote-jobs/remote-general-shop-heico-1135437",
  "scraped_at": "2026-07-27T10:37:21.001Z"
}
```

### Use cases

- **Remote job aggregation** — feed a niche board, newsletter or Slack alert with structured listings.
- **Remote salary benchmarking** — filter to records that actually disclose a range and band by tag.
- **Tech-stack demand tracking** — the `tags` array is already normalised by RemoteOK, so counting demand per technology needs no parsing.
- **Remote-hiring company discovery** — build a list of companies that genuinely hire remotely, filtered by stack.
- **Job-alert automation** — run on a schedule with a keyword filter and push new matches downstream.

### FAQ

#### Why not just call the RemoteOK feed myself?

You can, and for a raw dump you should. This actor exists for the two defects in that feed: 68 of 100 live records carry double-encoded text, so 'colaboração' arrives as 'colaboração', and undisclosed salaries are published as 0 rather than null. Both are repaired here — text is decoded back to correct UTF-8, and a 0 salary is returned as absent so it never reads as a zero-paying job.

#### How do I filter results?

By `keyword`, which matches title, company and tags, and by `tags`, which matches RemoteOK's own tag vocabulary. Both are optional; leave them empty to take the whole board.

#### How fresh is the data?

It is the live feed at run time — RemoteOK updates continuously and `posted_at` gives the exact posting timestamp.

#### Is salary always present?

No. Most listings do not disclose one. When a range is published you get `salary_min` and `salary_max`; when it is not, both fields are absent rather than zero.

### Billing

Pay per event: one `job-scraped` event per delivered record, charged only **after** the record is validated and stored. Empty results, blocked pages and duplicates are never charged. Store discounts apply automatically on paid Apify plans.

### Use in Claude, ChatGPT & any MCP agent

This actor runs as an MCP server, so an AI agent can call it directly:

```
https://mcp.apify.com/?tools=themineworks/remoteok-jobs-scraper
```

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("themineworks/remoteok-jobs-scraper").call(run_input={"keyword": "python", "tags": [], "maxJobs": 10})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

### Legal and compliance

This actor collects only publicly available information — the same data any visitor can see without logging in. It does not access private or authenticated areas, does not attempt to bypass paywalls, and collects no personal data beyond what the source already publishes openly. You are responsible for using the output in line with the source site's terms and with the data protection law that applies to you.

MIT © [The Mine Works](https://apify.com/themineworks)

# Actor input Schema

## `keyword` (type: `string`):

Filter jobs whose title, company or tags contain this keyword.

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

Only return jobs carrying at least one of these RemoteOK tags, e.g. 'engineer'.

## `maxJobs` (type: `integer`):

Maximum jobs to return.

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

Datacenter proxy is sufficient for this public feed.

## Actor input object example

```json
{
  "keyword": "python",
  "tags": [],
  "maxJobs": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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 = {
    "keyword": "python",
    "tags": [],
    "maxJobs": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 = {
    "keyword": "python",
    "tags": [],
    "maxJobs": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

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

```

## MCP server setup

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

```

## OpenAPI specification

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