# RemoteOK Scraper \[Just 💰$1] — Remote Jobs, Tags & Salaries (`blackfalcondata/remoteok-scraper`) Actor

💰 $1 per 1,000 jobs. Scrape remoteok.com — remote job titles, company & skill tags · salary range when listed · direct apply URL · filter by tag, location or company. Incremental mode tracks new and changed jobs across scheduled runs.

- **URL**: https://apify.com/blackfalcondata/remoteok-scraper.md
- **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 77 total users, 3 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.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 RemoteOK Scraper do?

RemoteOK Scraper extracts structured job data from [remoteok.com](https://remoteok.com) — including salary data, apply URLs, company metadata, full descriptions, and tags. It supports location filters and controllable result limits, so you can run the same query consistently over time. The actor also offers detail enrichment (full descriptions and company metadata) where the source provides them.

### How to use this actor

- 👉 **Register for a free Apify account** — no credit card required.
- 🎉 Just click **[Sign up free on Apify →](https://console.apify.com/sign-up?fpr=1h3gvi)** and complete a quick signup.
- 💰 A free Apify account includes $5 in monthly credits — enough to test this actor.
- ⏳ Scrape during the free trial, with no commitment or upfront payment required.

### Key features

- **🔔 Notifications:** Telegram, Slack, Discord, WhatsApp Cloud API, generic webhook — out of the box. Pair with incremental + `notifyOnlyChanges` for daily "new Remoteok jobs" pings to your hiring channel.
- **📧 Email + phone extraction:** best-effort regex extraction of contact emails and phone numbers from the listing description. Populated only when the source listing exposes the data — many listings hide contact info behind apply-flows, so null/empty is normal. Both `extractedEmails` and `extractedPhones` are arrays; an empty array means the page was scanned but nothing matched, while `null` means the extraction step was skipped.
- **🔗 URL + social-profile extraction:** every record carries `extractedUrls[]` and structured `socialProfiles { linkedin, twitter, github, … }` parsed from the description — useful when employers drop their careers page or recruiter LinkedIn in-line.
- **📦 Compact mode:** AI-agent and MCP-friendly compact payloads with core fields only — pipe straight into your ATS, salary-benchmarking tool, or LLM context without parsing extras.
- **✂️ Description truncation:** cap description length with `descriptionMaxLength` to control LLM prompt cost and dataset size — set 0 for full descriptions, or any char-limit to trim.
- **📌 Change classification:** each record carries a `changeType` of NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Default emits NEW + UPDATED + REAPPEARED; opt into the others with `emitUnchanged` / `emitExpired`.
- **♻️ Incremental mode:** recurring runs emit only NEW / UPDATED / REAPPEARED records — UNCHANGED and EXPIRED are opt-in. First run builds the baseline; subsequent runs emit and charge only for the diff. Pair with notifications for daily "new jobs" alerts to your hiring team. Saves 80–95% on daily monitoring.
- **📤 Export anywhere:** Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, …).
- **🔌 MCP connectors:** export your results into Notion via Apify's MCP connectors — a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows.

### What data can you extract from RemoteOK?

Each result includes Core job fields (`jobId`, `title`, `location`, `tags`, `salaryMin`, `salaryMax`, `salaryCurrency`, and `salaryPeriod`, and more), detail fields when enrichment is enabled (`description`, `descriptionHtml`, and `descriptionMarkdown`), apply information (`applyUrl`), and company metadata (`company`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned.

Enable detail enrichment in the input to get richer fields such as full descriptions and company metadata where the source provides them.

### Input

The main inputs are an optional location filter and a result limit. Additional filters and options are available in the input schema.

Key parameters:

- **`tag`** — Filter by skill or technology tag, e.g. "javascript", "python", "devops", "react". Enter several separated by commas to get jobs matching any of them. Leave blank for all recent remote jobs.
- **`location`** — Filter jobs by geographic restriction, e.g. "usa", "europe", "worldwide". Note: many remote jobs have no location restriction.
- **`company`** — Filter jobs by company name, e.g. "github", "stripe". Leave blank for all companies.
- **`minSalary`** — Only return jobs whose listed salary reaches this yearly USD amount (the top of the range is compared). Jobs without a listed salary are excluded. Leave blank for no salary filter.
- **`fullBoard`** — Return the complete board instead of only the ~96 most recent listings. Adds benefits, employment type, applicant locations and expiry date to jobs where available. Combine with Max Results = 0 for everything. (default: `false`)
- **`maxResults`** — Maximum number of jobs to return (0 = all available: ~96 most recent, or the whole board when Full Job Board is on). Values above 0 are capped at 200. (default: `100`)
- **`descriptionMaxLength`** — Truncate job description HTML to N characters. 0 = no truncation. (default: `0`)
- **`compact`** — Return core fields only (jobId, title, company, location, tags, salaryText, applyUrl, url, postedDate). Ideal for AI-agent and MCP workflows. (default: `false`)
- **`incrementalMode`** — Only emit jobs not seen in a previous run. Tracks state per stateKey. Ideal for daily schedulers — avoids duplicate processing. (default: `false`)
- **`stateKey`** — Scope key for incremental state. Defaults to a hash of tag+location+company. Override when running multiple schedules against the same filters.
- **`emitUnchanged`** — Also emit jobs that have not changed since the last run. (default: `false`)
- **`emitExpired`** — Also emit jobs that have disappeared since the last run. (default: `false`)
- ...and 19 more parameters

### Input examples

**Company-specific remote jobs** — Find current RemoteOK listings for a known hiring company.

→ Recent matching jobs with salary, tags, apply URL, and change-tracking fields when incremental mode is enabled.

```json
{
  "company": "github",
  "maxResults": 25
}
```

**Company jobs with skill and region filters** — Narrow a company search by skill tag and applicant region.

→ Filtered RemoteOK jobs for the selected company, tag, and location.

```json
{
  "company": "github",
  "tag": "javascript",
  "location": "usa",
  "maxResults": 25
}
```

**Incremental company monitoring** — Track a stable company search and emit only new or changed listings on later runs.

→ Change-classified RemoteOK jobs for the selected company search.

```json
{
  "company": "github",
  "maxResults": 25,
  "incrementalMode": true,
  "stateKey": "github-remoteok-monitor"
}
```

### Output

Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

### Example job record

```json
{
  "jobId": "fa67e263e695801200dd9dab54456d42d3a65c530ef1c30fb787279e8945c691",
  "title": "E Commerce Sales Executive",
  "company": "FoodMe Global / Dine Palace",
  "tags": [
    "dev",
    "junior",
    "engineer",
    "digital nomad",
    "hr",
    "... 34 more items"
  ],
  "description": "Posted 7:00:00 AM. This is a remote position.Job Title: E-Commerce Sales Executive â Printers & Computer Accessoriesâ¦See this and similar jobs on LinkedIn.\n\nPlease mention the word **GRACEFUL** an...",
  "descriptionHtml": "Posted 7:00:00 AM. This is a remote position.Job Title: E-Commerce Sales Executive â Printers & Computer Accessoriesâ¦See this and similar jobs on LinkedIn.<br/><br/>Please mention the word **GRACE...",
  "descriptionMarkdown": "Posted 7:00:00 AM. This is a remote position.Job Title: E-Commerce Sales Executive â Printers & Computer Accessoriesâ¦See this and similar jobs on LinkedIn.\n\nPlease mention the word **GRACEFUL** an...",
  "contentHash": "ad584ff9720f0d17bf95a223ff55416f5db8b4f912c0798b2bc31467333e3d50",
  "applyUrl": "https://remoteOK.com/remote-jobs/remote-e-commerce-sales-executive-foodme-global-dine-palace-1133259",
  "url": "https://remoteOK.com/remote-jobs/remote-e-commerce-sales-executive-foodme-global-dine-palace-1133259",
  "postedDate": "2026-06-11T16:10:01+02:00",
  "postedAt": "2026-06-11T16:10:01+02:00",
  "isVerified": false,
  "portalUrl": "https://remoteOK.com/remote-jobs/remote-e-commerce-sales-executive-foodme-global-dine-palace-1133259",
  "scrapedAt": "2026-06-14T21:51:49.442Z",
  "source": "remoteok.com",
  "changeType": "NEW",
  "firstSeenAt": "2026-06-14T21:51:49.442Z",
  "lastSeenAt": "2026-06-14T21:51:49.442Z",
  "isRepost": false
}
```

### Incremental fields

When incremental mode is on, each record also carries:

- `changeType` — one of `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, `EXPIRED`. Default output covers `NEW` / `UPDATED` / `REAPPEARED`; set `emitUnchanged: true` or `emitExpired: true` to opt into the others.
- `firstSeenAt`, `lastSeenAt` — ISO-8601 timestamps tracking the listing across runs.
- `isRepost`, `repostOfId`, `repostDetectedAt` — populated when a new listing matches the tracked content of a previously expired one. Set `skipReposts: true` to drop detected reposts from the output.

### How to scrape RemoteOK

1. Go to [RemoteOK Scraper](https://apify.com/blackfalcondata/remoteok-scraper?fpr=1h3gvi) in Apify Console.
2. Configure the input and optional location filter.
3. Set `maxResults` to control how many results you need.
4. Enable `includeDetails` if you need full descriptions, company data.
5. Click **Start** and wait for the run to finish.
6. Export the dataset as JSON, CSV, or Excel.

### Use cases

- Extract job data from RemoteOK for market research and competitive analysis.
- Track salary trends across regions and categories over time.
- Monitor new and changed jobs on scheduled runs without processing the full dataset every time.
- Auto-apply or feed apply URLs into your ATS / hiring pipeline.
- Research company hiring patterns, employer profiles, and industry distribution.
- Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode.
- Export clean, structured data to dashboards, spreadsheets, or data warehouses.

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

RemoteOK Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced.

- **Run start:** $0.005 per run
- **Per result:** $0.001 per job record

Example costs:

- 10 results: **$0.015**
- 25 results: **$0.03**
- 100 results: **$0.11**
- 200 results: **$0.21**
- 200 results: **$0.21**

#### Example: recurring monitoring savings

These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of jobs that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency — the scenarios below are examples, not predictions.

Example setup: 200 jobs per run, daily polling (30 runs/month). Costs scale linearly with the number of jobs.

| Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline |
|---|---:|---:|---:|---:|
| 5% — stable niche query | $0.21 | $0.01 | $0.19 (93%) | $0.45 |
| 15% — moderate broad query | $0.21 | $0.03 | $0.17 (83%) | $1.05 |
| 30% — high-volume aggregator | $0.21 | $0.07 | $0.14 (68%) | $1.95 |

Full re-scrape monthly cost at the same cadence: $6.15. First month with incremental costs $0.64 / $1.22 / $2.09 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply.

Platform usage is included in the per-result fee shown above.

### FAQ

#### How many results can I get from RemoteOK?

The number of results depends on the search query and available jobs on RemoteOK. Use the `maxResults` parameter to control how many results are returned per run.

#### Does RemoteOK Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed jobs on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset.

#### Can I integrate RemoteOK Scraper with other apps?

Yes. RemoteOK Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

#### Can I use RemoteOK Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages.

#### Can I use RemoteOK Scraper through an MCP Server?

Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use compact mode, `descriptionMaxLength`, a single `descriptionFormat`, and `excludeEmptyFields` to keep payloads manageable for LLM context windows.

#### Is it legal to scrape RemoteOK?

This actor extracts publicly available data from RemoteOK. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

#### Your feedback

If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/remoteok-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve.

### You might also like

- [Actiris Job Scraper \[Just 💰$1.5\] — Brussels Public Jobs](https://apify.com/blackfalcondata/actiris-scraper?fpr=1h3gvi) — 💰 $1.5 per 1,000 jobs. Scrape actiris.brussels — the official Brussels public employment service.
- [AMS Austria Job Scraper — Public Employment Service Jobs](https://apify.com/blackfalcondata/ams-austria-job-scraper?fpr=1h3gvi) — Scrape jobs.ams.at, Austria's official AMS public employment portal (alle jobs). Get live.
- [APEC Job Scraper \[Just 💰$0.8\] — French Executive Jobs](https://apify.com/blackfalcondata/apec-scraper?fpr=1h3gvi) — 💰 $0.8 per 1,000 jobs, platform usage included. Scrape apec.fr French executive listings — every.
- [Arbeitsagentur Job Scraper \[💰$0.45\] — German Federal Jobs](https://apify.com/blackfalcondata/arbeitsagentur-jobs-feed?fpr=1h3gvi) — 💰 from $0.45 per 1,000 jobs. Scrape arbeitsagentur.de — Germany's official public employment.
- [Arbetsförmedlingen Job Scraper \[Just 💰$3\] — Sweden Public](https://apify.com/blackfalcondata/arbetsformedlingen-scraper?fpr=1h3gvi) — 💰 $3 per 1,000 jobs. Scrape arbetsformedlingen.se (Platsbanken) — Sweden's official employment.
- [Bayt Job Scraper — MENA Jobs with Salary & Skills](https://apify.com/blackfalcondata/bayt-scraper?fpr=1h3gvi) — Scrape bayt.com — the leading Middle East job board across UAE · Saudi Arabia · Qatar · Egypt & 9.
- [BestJobs.eu \[Just 💰$1.5\] — Romania Job Board](https://apify.com/blackfalcondata/bestjobs-eu-scraper?fpr=1h3gvi) — 💰 $1.5 per 1,000 jobs. Scrape bestjobs.eu — a leading Romanian job board — export salary ranges ·.
- [Bumeran Scraper \[Just 💰$1\] — LATAM Jobs (7 Countries)](https://apify.com/blackfalcondata/bumeran-scraper?fpr=1h3gvi) — 💰 $1 per 1,000 jobs. Scrape Bumeran Group across LATAM — Argentina · Chile · Ecuador · Mexico ·.

### Getting started with Apify

New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi) — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click **Start** — export results as JSON, CSV, or Excel

Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi).

### Disclaimer

This actor accesses only publicly available data on remoteok.com. You are responsible for how you use the extracted data — in particular any personal information such as names, phone numbers, or email addresses — and for complying with RemoteOK's terms of use, applicable data-protection law (including the GDPR where it applies), and the anti-spam rules of your jurisdiction.

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by RemoteOK or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

### Search keywords

remoteok scraper, remoteok api, apify remoteok, remoteok data extraction, remoteok.com scraper, remoteok.com data, remoteok.com api, job listings scraper, recruitment data, hiring data, job board scraper, remoteok jobs, remote jobs scraper, remote developer jobs, work from home jobs data, tech remote jobs, remote job board scraper.

# Changelog

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

# Actor input Schema

## `tag` (type: `string`):

Filter by skill or technology tag, e.g. "javascript", "python", "devops", "react". Enter several separated by commas to get jobs matching any of them. Leave blank for all recent remote jobs.

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

Filter jobs by geographic restriction, e.g. "usa", "europe", "worldwide". Note: many remote jobs have no location restriction.

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

Filter jobs by company name, e.g. "github", "stripe". Leave blank for all companies.

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

Only return jobs whose listed salary reaches this yearly USD amount (the top of the range is compared). Jobs without a listed salary are excluded. Leave blank for no salary filter.

## `fullBoard` (type: `boolean`):

Return the complete board instead of only the ~96 most recent listings. Adds benefits, employment type, applicant locations and expiry date to jobs where available. Combine with Max Results = 0 for everything.

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

Maximum number of jobs to return (0 = all available: ~96 most recent, or the whole board when Full Job Board is on). Values above 0 are capped at 200.

## `descriptionMaxLength` (type: `integer`):

Truncate job description HTML to N characters. 0 = no truncation.

## `compact` (type: `boolean`):

Return core fields only (jobId, title, company, location, tags, salaryText, applyUrl, url, postedDate). Ideal for AI-agent and MCP workflows.

## `incrementalMode` (type: `boolean`):

Only emit jobs not seen in a previous run. Tracks state per stateKey. Ideal for daily schedulers — avoids duplicate processing.

## `stateKey` (type: `string`):

Scope key for incremental state. Defaults to a hash of tag+location+company. Override when running multiple schedules against the same filters.

## `emitUnchanged` (type: `boolean`):

Also emit jobs that have not changed since the last run.

## `emitExpired` (type: `boolean`):

Also emit jobs that have disappeared since the last run.

## `skipReposts` (type: `boolean`):

When incremental, skip jobs whose content matches a previously expired job.

## `telegramToken` (type: `string`):

Telegram bot token (from @BotFather). Required for Telegram notifications.

## `telegramChatId` (type: `string`):

Telegram chat or channel ID. Required when telegramToken is set.

## `discordWebhookUrl` (type: `string`):

Discord incoming webhook URL.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook URL.

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token. Recipient must have messaged your business number within last 24h.

## `whatsappPhoneNumberId` (type: `string`):

WhatsApp Business phone-number ID. Required when whatsappAccessToken is set.

## `whatsappTo` (type: `string`):

Recipient phone in E.164 format without +.

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

Receives a JSON POST with {metadata, items} after each run.

## `webhookHeaders` (type: `object`):

Optional JSON object of custom headers.

## `notificationLimit` (type: `integer`):

Maximum number of jobs included in each notification message (1–20).

## `notifyOnlyChanges` (type: `boolean`):

When Incremental Mode is on, only send notifications for NEW and UPDATED jobs.

## `phoneExtractionMode` (type: `string`):

Strict (Tel:/+CC prefix only) or Lenient (also bare local numbers).

## `descriptionFormat` (type: `string`):

Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.

## `excludeEmptyFields` (type: `boolean`):

Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.

## `appConnector` (type: `string`):

Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog.

## `mcpIssueTeam` (type: `string`):

Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one.

## `startUrls` (type: `array`):

One or more RemoteOK tag-search, browse, or job listing URLs to process. When set, other search filters are ignored.

## `includeDetails` (type: `boolean`):

RemoteOK already includes full descriptions and contact data in every API record. This compatibility setting does not trigger an extra request.

## Actor input object example

```json
{
  "tag": "javascript",
  "fullBoard": true,
  "maxResults": 100,
  "descriptionMaxLength": 0,
  "compact": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "skipReposts": false,
  "notificationLimit": 5,
  "notifyOnlyChanges": false,
  "phoneExtractionMode": "strict",
  "descriptionFormat": "all",
  "excludeEmptyFields": false,
  "includeDetails": false
}
```

# 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 = {
    "tag": "javascript",
    "fullBoard": true,
    "maxResults": 100,
    "descriptionFormat": "all",
    "excludeEmptyFields": false,
    "includeDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("blackfalcondata/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 = {
    "tag": "javascript",
    "fullBoard": True,
    "maxResults": 100,
    "descriptionFormat": "all",
    "excludeEmptyFields": False,
    "includeDetails": False,
}

# Run the Actor and wait for it to finish
run = client.actor("blackfalcondata/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 '{
  "tag": "javascript",
  "fullBoard": true,
  "maxResults": 100,
  "descriptionFormat": "all",
  "excludeEmptyFields": false,
  "includeDetails": false
}' |
apify call blackfalcondata/remoteok-scraper --silent --output-dataset

```

## MCP server setup

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