# Remote-Jobs Aggregator (`straightforward_hydra/remote-jobs-aggregator-9-in-one`) Actor

Search 9 remote job boards (RemoteOK, Remotive, The Muse, Arbeitnow, Jobicy, Himalayas, Working Nomads, We Work Remotely, Landing.jobs) in one run. Unified, de-duplicated jobs or a market digest. No key.

- **URL**: https://apify.com/straightforward\_hydra/remote-jobs-aggregator-9-in-one.md
- **Developed by:** [Dev D](https://apify.com/straightforward_hydra) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 digests

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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use 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

## Remote-Jobs Aggregator 🌍💼

**Search 9 remote job boards in a single run and get every matching remote role in one clean, de-duplicated schema — or a market digest of who's hiring, in what, and where. No API key, no proxy.**

Remote job listings are scattered across dozens of boards, each with its own format. This Actor speaks the public feeds of the biggest ones and normalizes them into **one schema**, so a single search sweeps them all at once:

**RemoteOK · Remotive · The Muse · Arbeitnow · Jobicy · Himalayas · Working Nomads · We Work Remotely · Landing.jobs**

Perfect for **job boards & aggregators, remote-work newsletters, salary/market research, talent CRMs, and job-alert bots** — a clean, public-data feed of the remote job market.

---

### Two modes

- **Unified jobs** (default) — one row **per matching remote job**, in a single schema across all 9 boards (title, company, board, category, job type, location, salary, apply URL, posted date…). De-duplicated so the same role on two boards appears once.
- **Market digest** — a single summary row: total jobs, counts by board, **top hiring companies**, top categories, top locations, job-type mix, salary coverage, and a sample of current titles. Great for "state of the remote market this week."

### Input

Everything is optional — with no filters it pulls the latest across all 9 boards.

```json
{
  "search": "python",
  "sources": ["remoteok", "remotive", "weworkremotely", "jobicy"],
  "mode": "jobs",
  "jobType": "full_time",
  "location": "USA"
}
````

| Filter | Effect |
|---|---|
| `search` | keyword in title, company, category or tags (e.g. `engineer`, `designer`) |
| `sources` | which boards to search (leave empty = all 9) |
| `category` | category / tag contains this text (e.g. `marketing`, `devops`) |
| `location` | candidate-location text contains this (e.g. `USA`, `Europe`, `worldwide`) |
| `company` | company name contains this text |
| `jobType` | full-time, part-time, contract, freelance, internship, temporary |
| `dedupe` | drop the same role across boards (matched by company + title) |

### Output — a unified job

```json
{
  "source": "jobicy",
  "source_id": "146556",
  "company": "Reddit",
  "title": "Machine Learning Engineering Manager — Ads",
  "category": "Data Science & Analytics",
  "tags": ["Data Science & Analytics"],
  "job_type": "full_time",
  "location": "USA",
  "salary": "USD 230,000–322,000",
  "salary_min": 230000,
  "salary_max": 322000,
  "salary_currency": "USD",
  "url": "https://jobicy.com/jobs/146556-...",
  "company_logo": "https://…",
  "posted_at": "2026-07-16T13:28:02+00:00"
}
```

### Output — market digest

```json
{
  "total_jobs": 253,
  "jobs_by_source": [{ "name": "remoteok", "count": 30 }, ...],
  "top_companies": [{ "name": "Lemon.io", "count": 4 }, ...],
  "top_categories": [{ "name": "Software Development", "count": 41 }, ...],
  "top_locations": [{ "name": "USA", "count": 60 }, ...],
  "job_types": [{ "name": "full_time", "count": 120 }, ...],
  "jobs_with_salary": 54,
  "salary_pct": 21.3
}
```

### Run it on a schedule

Point it at your keyword/category daily or weekly and pipe fresh remote roles to a sheet, database, Slack, webhook or your own job board — or track the digest over time to watch the remote market move.

### Notes & limitations

- **No API key, no proxy** — every source is a public remote-jobs feed (JSON or RSS).
- Field coverage varies by board — some expose salary or employment type, some don't; the unified schema fills what each source provides (a few boards don't publish company names or salaries).
- A board that is temporarily unreachable is skipped gracefully; one bad board never fails the whole run.
- Boards that carry on-site roles too (The Muse, Arbeitnow, Landing.jobs) are filtered to **remote-only** before merging.
- Data source: each board's own public jobs feed.

***

#### Keywords

remote jobs, remote work, work from home jobs, remote job board, jobs aggregator, RemoteOK, Remotive, The Muse, Arbeitnow, Jobicy, Himalayas, Working Nomads, We Work Remotely, Landing.jobs, remote job feed, job scraper, job alerts, remote developer jobs, remote marketing jobs, tech jobs API, salary data, job market data, recruiting intelligence, job aggregator API.

# Actor input Schema

## `search` (type: `string`):

Only keep jobs whose title, company, category or tags contain this text, e.g. "python", "designer", "sales". Leave empty to pull everything.

## `sources` (type: `array`):

Which remote boards to include. Leave empty to search all 9. Valid slugs: remoteok, remotive, themuse, arbeitnow, jobicy, himalayas, workingnomads, weworkremotely, landingjobs.

## `mode` (type: `string`):

jobs = one unified row per matching remote job. digest = a single market-summary row (top companies, categories, locations, counts by board).

## `category` (type: `string`):

Only jobs whose category or tags contain this text, e.g. "marketing", "devops".

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

Only jobs whose candidate-location text contains this, e.g. "USA", "Europe", "worldwide".

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

Only jobs whose company name contains this text.

## `jobType` (type: `string`):

Only jobs of this employment type.

## `dedupe` (type: `boolean`):

Drop the same role when it appears on more than one board (matched by company + title).

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

Include the full job description text in jobs mode (larger output).

## `maxJobsPerSource` (type: `integer`):

Cap on jobs fetched from each board before filtering.

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

Overall cap on jobs returned across all boards.

## Actor input object example

```json
{
  "search": "engineer",
  "sources": [
    "remoteok",
    "remotive",
    "themuse",
    "arbeitnow",
    "jobicy",
    "himalayas",
    "workingnomads",
    "weworkremotely",
    "landingjobs"
  ],
  "mode": "jobs",
  "jobType": "any",
  "dedupe": true,
  "includeDescription": false,
  "maxJobsPerSource": 200,
  "maxJobs": 2000
}
```

# 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 = {
    "search": "engineer",
    "sources": [
        "remoteok",
        "remotive",
        "themuse",
        "arbeitnow",
        "jobicy",
        "himalayas",
        "workingnomads",
        "weworkremotely",
        "landingjobs"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("straightforward_hydra/remote-jobs-aggregator-9-in-one").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 = {
    "search": "engineer",
    "sources": [
        "remoteok",
        "remotive",
        "themuse",
        "arbeitnow",
        "jobicy",
        "himalayas",
        "workingnomads",
        "weworkremotely",
        "landingjobs",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("straightforward_hydra/remote-jobs-aggregator-9-in-one").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 '{
  "search": "engineer",
  "sources": [
    "remoteok",
    "remotive",
    "themuse",
    "arbeitnow",
    "jobicy",
    "himalayas",
    "workingnomads",
    "weworkremotely",
    "landingjobs"
  ]
}' |
apify call straightforward_hydra/remote-jobs-aggregator-9-in-one --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=straightforward_hydra/remote-jobs-aggregator-9-in-one",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Remote-Jobs Aggregator",
        "description": "Search 9 remote job boards (RemoteOK, Remotive, The Muse, Arbeitnow, Jobicy, Himalayas, Working Nomads, We Work Remotely, Landing.jobs) in one run. Unified, de-duplicated jobs or a market digest. No key.",
        "version": "0.1",
        "x-build-id": "Vz9OMjWmNg1UuajgP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/straightforward_hydra~remote-jobs-aggregator-9-in-one/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-straightforward_hydra-remote-jobs-aggregator-9-in-one",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/straightforward_hydra~remote-jobs-aggregator-9-in-one/runs": {
            "post": {
                "operationId": "runs-sync-straightforward_hydra-remote-jobs-aggregator-9-in-one",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/straightforward_hydra~remote-jobs-aggregator-9-in-one/run-sync": {
            "post": {
                "operationId": "run-sync-straightforward_hydra-remote-jobs-aggregator-9-in-one",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "search": {
                        "title": "Search keyword",
                        "type": "string",
                        "description": "Only keep jobs whose title, company, category or tags contain this text, e.g. \"python\", \"designer\", \"sales\". Leave empty to pull everything."
                    },
                    "sources": {
                        "title": "Boards to search",
                        "type": "array",
                        "description": "Which remote boards to include. Leave empty to search all 9. Valid slugs: remoteok, remotive, themuse, arbeitnow, jobicy, himalayas, workingnomads, weworkremotely, landingjobs.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "jobs",
                            "digest"
                        ],
                        "type": "string",
                        "description": "jobs = one unified row per matching remote job. digest = a single market-summary row (top companies, categories, locations, counts by board).",
                        "default": "jobs"
                    },
                    "category": {
                        "title": "Category / tag",
                        "type": "string",
                        "description": "Only jobs whose category or tags contain this text, e.g. \"marketing\", \"devops\"."
                    },
                    "location": {
                        "title": "Location / region",
                        "type": "string",
                        "description": "Only jobs whose candidate-location text contains this, e.g. \"USA\", \"Europe\", \"worldwide\"."
                    },
                    "company": {
                        "title": "Company",
                        "type": "string",
                        "description": "Only jobs whose company name contains this text."
                    },
                    "jobType": {
                        "title": "Job type",
                        "enum": [
                            "any",
                            "full_time",
                            "part_time",
                            "contract",
                            "freelance",
                            "internship",
                            "temporary"
                        ],
                        "type": "string",
                        "description": "Only jobs of this employment type.",
                        "default": "any"
                    },
                    "dedupe": {
                        "title": "De-duplicate across boards",
                        "type": "boolean",
                        "description": "Drop the same role when it appears on more than one board (matched by company + title).",
                        "default": true
                    },
                    "includeDescription": {
                        "title": "Include description (jobs mode)",
                        "type": "boolean",
                        "description": "Include the full job description text in jobs mode (larger output).",
                        "default": false
                    },
                    "maxJobsPerSource": {
                        "title": "Max jobs per board",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Cap on jobs fetched from each board before filtering.",
                        "default": 200
                    },
                    "maxJobs": {
                        "title": "Max jobs (total)",
                        "minimum": 1,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Overall cap on jobs returned across all boards.",
                        "default": 2000
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```