# Remote OK Jobs Scraper: Remote Jobs, Salaries & Tags (`notarealgamedev/remoteok-jobs`) Actor

Remote jobs from Remote OK's public API for your tags, in clean JSON: company, yearly salary, level, type, department, tags, verified company, repaired text. Each job once across tags, only-new monitoring, signed webhook.

- **URL**: https://apify.com/notarealgamedev/remoteok-jobs.md
- **Developed by:** [NotAReal GameDev](https://apify.com/notarealgamedev) (community)
- **Categories:** Jobs, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 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/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

### What does Remote OK Jobs Scraper do?

It reads **Remote OK**, the remote-only job board, through its public JSON API, for the tags you choose (`python`, `customer support`, `design`…). Every job comes back as clean, flat JSON with the same fields as Career Page Jobs, plus Remote OK's own facts in `extras`.

No login, API key, browser or proxy is needed. The Actor follows Remote OK's API terms and robots.txt (see **Attribution** below).

**Typical uses**

- **Job boards and newsletters**: new remote jobs for your niche, every day.
- **Job alerts**: only the jobs you haven't seen, sent to your own webhook.
- **Recruiters and sales teams**: which companies hire remotely, for which roles and at what pay.
- **Salary and market research**: yearly pay, levels and departments across remote jobs.

### Why this one

| | What you get |
|---|---|
| **Each job once** | Remote OK lists about 100 jobs per tag, and the same job appears under many tags. A job is delivered and charged once per run, and in monitoring mode never again for any of your tags. |
| **Clean text** | Many Remote OK ads come with broken characters (`itâ€™s`, `Â`): 80 of 197 listings read on 14 Nov 2026. They are repaired, and HTML entities in titles (`&amp;`) are decoded. |
| **Facts you can trust** | Remote OK's tags are broad: on 14 Nov 2026, 50 of its 97 latest jobs were tagged "customer support", 9 software engineers and developers among them, and some jobs carry "part time", "full time" and "internship" at once. So the department, level and employment type come from the job title and the ad itself, not from tags. Salary figures that cannot be a yearly salary (such as 21–21 or 114,000,000) are kept aside in `salaryAsListed`, and pay written in the ad (hourly rates too) is read when the salary fields are empty. |
| **Filters that save money** | Words in title, company or tags; minimum yearly pay (an hourly rate counts 2,080 times); level; employment type; location; posting date; language; verified companies; technical roles only; a maximum per tag and in total. **Jobs removed by filters are not charged.** |
| **Monitoring** | Only new jobs per monitor name. A job that drops out of Remote OK's latest-100 window is not reported as closed, because it has not necessarily closed. |
| **Webhook** | The delivered jobs are POSTed to your endpoint in batches of 50, signed with HMAC-SHA256. |
| **No personal data** | Recruiters' personal e-mail addresses and phone numbers in ads are removed (shared mailboxes such as careers@ stay). |
| **Same fields as Career Page Jobs** | Remote OK jobs, company career-page jobs (Greenhouse, Lever, Workday and more) and public job services fit in one table. |

**Test:** 14 November 2026, tags `python`, `customer support`, `design` and `*` (latest jobs), no limit.

- 394 listings, **254 different jobs**, in 8.4 seconds.
- 212 of 254 with a department, 94 with a level, 198 with a location restriction (107 with a country code).
- 62 with pay: 47 yearly salaries from Remote OK's fields and 14 hourly rates read from the ad; 4 implausible figures kept aside.
- No ad left with broken characters. Languages: 235 English, 7 Spanish, 5 Portuguese, 3 French.

**Requests and time:** one request per tag plus robots.txt, paced at the one second robots.txt asks for. Jobs are merged in one pass with a set of job keys, so N listings take Θ(N) time however many tags share them, and a monitored job is looked up in O(1).

### How to use it

1. Write one or more Remote OK tags in **Tags**, one per line: `python`, `golang`, `customer support`, `design`, `marketing`… `dev+python` keeps jobs that have both tags; `*` reads the latest jobs of every kind. A link such as `https://remoteok.com/remote-python-jobs` works too.
2. Optionally add filters. **Jobs removed by filters are not charged.**
3. Click **Start**. Download the results as JSON, CSV or Excel, or get them through the API.

For a daily feed, schedule the Actor with **Only new jobs** on. Remote OK shows about 100 jobs per tag, so a daily run collects every new job of a busy tag.

#### Input example

```json
{
  "companies": ["python", "golang", "devops"],
  "minSalary": 100000,
  "seniorities": ["senior", "lead"],
  "techRolesOnly": true,
  "onlyNewJobs": true,
  "monitorId": "remote-backend",
  "webhookUrl": "https://example.com/hooks/remote-jobs",
  "webhookSecret": "a-long-random-string"
}
```

Input written for other Remote OK scrapers works as it is: `tags`, `keywordFilter`, `minSalary`, `includeUnverified`, `filterNonTech`, `maxResults`, `webhookUrl` and `webhookSecret` are understood.

### Output

One row per job. Example (shortened):

```json
{
  "title": "Research Engineer Privacy and Anonymization",
  "companyName": "Pragmatike",
  "ats": "remoteok",
  "board": "python",
  "jobId": "1137792",
  "jobKey": "remoteok:1137792",
  "department": "Engineering",
  "location": null,
  "workplaceType": "remote",
  "employmentType": null,
  "seniority": null,
  "salaryMin": null,
  "salaryMax": null,
  "postedAt": "2026-11-12T16:00:38Z",
  "language": "en",
  "url": "https://remoteok.com/remote-jobs/remote-research-engineer-privacy-and-anonymization-pragmatike-1137792",
  "applyUrl": "https://remoteok.com/remote-jobs/remote-research-engineer-privacy-and-anonymization-pragmatike-1137792",
  "boardUrl": "https://remoteok.com/remote-python-jobs",
  "description": "…",
  "extras": {
    "tags": ["python", "infosec", "engineer", "full time"],
    "source": "Remote OK",
    "sourceTerms": "Link back to the job on Remote OK (a followed link) and name Remote OK as the source.",
    "contentSignal": "search=yes, ai-train=no, use=reference"
  }
}
```

`extras` holds Remote OK's own facts:

- `tags`: Remote OK's tags for the job (broad: good for search, not as categories)
- `verifiedCompany`: Remote OK marks the company as verified
- `postedOnBoard`: the job was posted on Remote OK itself
- `companyLogo`: the company's own logo, when listed
- `salaryAsListed`: salary figures that cannot be a yearly salary, kept as listed
- `source`, `sourceTerms`, `contentSignal`: where the job comes from, and on what terms (below)

The run summary (key-value store `OUTPUT`) lists every tag with its status, jobs listed, jobs delivered and the webhook result.

### Attribution

Remote OK's API terms ask anyone who shows its jobs to **link back to the job on Remote OK with a followed link (no `nofollow`) and name Remote OK as the source**, and not to use the Remote OK logo. Every row carries `url` (the job on Remote OK) and `extras.source` for exactly that. Remote OK's robots.txt also states `Content-Signal: search=yes, ai-train=no, use=reference`: the jobs may not be used to train AI models. Each row carries that signal in `extras.contentSignal`.

This Actor is not affiliated with or endorsed by Remote OK.

### Pricing

**$4.00 per 1,000 jobs delivered** ($0.004 per job), plus Apify's small charge per run start. Jobs removed by your filters are free, and so are jobs a monitor has already delivered. Other Remote OK scrapers cost about $1–2 per 1,000 jobs.

Examples:

- 5 tags with all their jobs, about 300 different jobs = **$1.20**.
- Daily monitoring of 5 tags with about 30 new jobs a day ≈ 900 jobs a month ≈ **$3.60 a month**.

### FAQ

**How many jobs does a tag return?** About 100, Remote OK's newest for that tag. For complete coverage, monitor daily with **Only new jobs** on.

**Why are some fields empty?** Remote OK leaves them empty: on 14 Nov 2026 about a fifth of its jobs named no location restriction and three quarters no salary. The Actor fills fields only from what the job and the ad really say.

**How are tags written?** As Remote OK writes them, in lower case: `customer support`, `sys admin`, `web dev`. In Career Page Jobs, `remoteok: python` reads the same feed.

# Changelog

This Actor's version history is a separate document: https://apify.com/notarealgamedev/remoteok-jobs/changelog.md

# Actor input Schema

## `companies` (type: `array`):

One Remote OK tag per line, e.g. "python", "customer support", "design" or "golang". "dev+python" keeps jobs that have both tags; "\*" reads the latest jobs of every kind. A Remote OK link such as https://remoteok.com/remote-python-jobs works too. A job found under several tags is delivered (and charged) once.

## `maxJobsPerCompany` (type: `integer`):

Newest jobs first. 0 = no limit (Remote OK lists about 100 jobs per tag). You pay per job delivered, so this also caps the cost per tag in each run.

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

The most jobs this run delivers across every entry together (0 = no limit). Also caps the cost of a run.

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains at least one of these words or phrases (not case-sensitive, whole words). Example: engineer, data, sales. Filtered-out jobs are free.

## `excludeTitleKeywords` (type: `array`):

Drop jobs whose title contains any of these words. Example: intern, senior.

## `locationKeywords` (type: `array`):

Keep only jobs whose location, country or remote type mentions one of these. Example: Oslo, Norway, NO, Remote.

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

Keep only jobs published in the last N days. Jobs without a publish date are kept.

## `languages` (type: `array`):

Keep only job ads written in these languages (stated by the job board, or detected from the ad text). Useful for, e.g., English-language jobs in Norway, Germany or the Netherlands. Ads whose language can't be determined (very short ads) are left out.

## `keywordFilter` (type: `array`):

Keep jobs where any of these words is in the title, the company name, the department or the job board's tags. Whole words, any case.

## `seniorities` (type: `array`):

Keep jobs of these levels, read from the title (and the job board's level when it has one). Jobs whose level is unknown are removed when this is set.

## `employmentTypes` (type: `array`):

Keep jobs of these types. Jobs whose type is not stated are removed when this is set.

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

Remove jobs whose highest stated pay is below this, per year (a monthly salary counts 12 times, a weekly 52, a daily 260, an hourly 2,080). Jobs without a salary pass unless "Only jobs with a salary" is on.

## `minSalaryCurrency` (type: `string`):

Optional, e.g. USD or EUR: only salaries in this currency are compared; others count as no salary.

## `requireSalary` (type: `boolean`):

Keep only jobs that state a salary (in the currency above, if one is set).

## `techRolesOnly` (type: `boolean`):

Remove jobs whose title is clearly not a technical role (receptionist, driver, nurse, accountant, recruiter, cashier and similar).

## `verifiedCompaniesOnly` (type: `boolean`):

Keep only jobs whose company Remote OK marks as verified.

## `postedAfter` (type: `string`):

Keep jobs posted on or after this date (jobs without a date pass).

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

Full ad text, ready for search or AI. Turn off for smaller exports.

## `includeDescriptionHtml` (type: `boolean`):

The original formatted ad, for re-publishing on your own job board.

## `onlyNewJobs` (type: `boolean`):

Return only jobs this monitor has not delivered before, so you never pay twice for a job. Schedule the Actor (e.g. daily) and you pay only for new jobs. Jobs that have closed since they were delivered are listed for free in the run's OUTPUT record.

## `monitorId` (type: `string`):

Keeps separate memories for separate watch lists, e.g. 'nordic-fintech' or 'client-a'. Letters, numbers, - and \_. Only one run per monitor can work at a time; a second one stops immediately instead of charging twice.

## `skipExistingOnFirstRun` (type: `boolean`):

The first time this monitor reads a company (also companies you add later), save its open jobs as the starting point without delivering them (free). From then on you get only newly posted jobs. Turns on monitoring mode.

## `webhookUrl` (type: `string`):

At the end of the run, the delivered jobs are POSTed here as JSON, 50 per request: {runId, monitorId, batch, batches, jobs}.

## `webhookSecret` (type: `string`):

Each request is signed with it: header X-Signature-256 = "sha256=" + HMAC-SHA256 of the body. For receivers made for other tools it is also sent as X-Scraper-Secret (https only).

## `maxConcurrency` (type: `integer`):

How many companies are read at the same time. The default is polite to the job boards; raise it only for very long lists.

## Actor input object example

```json
{
  "companies": [
    "python",
    "customer support"
  ],
  "maxJobsPerCompany": 5,
  "requireSalary": false,
  "techRolesOnly": false,
  "verifiedCompaniesOnly": false,
  "includeDescription": true,
  "includeDescriptionHtml": false,
  "onlyNewJobs": false,
  "monitorId": "default",
  "skipExistingOnFirstRun": false,
  "maxConcurrency": 6
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "companies": [
        "python",
        "customer support"
    ],
    "maxJobsPerCompany": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("notarealgamedev/remoteok-jobs").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 = {
    "companies": [
        "python",
        "customer support",
    ],
    "maxJobsPerCompany": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("notarealgamedev/remoteok-jobs").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 '{
  "companies": [
    "python",
    "customer support"
  ],
  "maxJobsPerCompany": 5
}' |
apify call notarealgamedev/remoteok-jobs --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,notarealgamedev/remoteok-jobs"
        }
    }
}
```

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/e7kKGKlnFsZP8f42B/builds/CaN1FVq3ChUput6Qo/openapi.json
