# Remote Jobs Aggregator — 5 Job Boards in One (`hipersoft/remote-jobs-aggregator`) Actor

Aggregate remote jobs from 5 boards (Remotive, Arbeitnow, Jobicy, Himalayas, Working Nomads) into one clean, de-duplicated dataset: title, company, category, job type, seniority, location, salary, tags, posted date, apply link and description. Fast clean HTTP, no login. Optional keyword filter.

- **URL**: https://apify.com/hipersoft/remote-jobs-aggregator.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0008 / job scraped

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 — 5 Job Boards in One, De-duplicated, Clean JSON

Aggregate remote jobs from five popular boards — Remotive, Arbeitnow, Jobicy, Himalayas and Working Nomads — into a single clean, de-duplicated dataset. Each listing is normalized to the same shape: title, company, category, job type, seniority, location, salary, tags, posted date, apply link and description. It pulls each board's public JSON API over fast, plain HTTP. No account, no API key. Ideal for anyone building a remote-work job board, a talent feed or a hiring-trends dataset without wiring up five different integrations.

### Features
- 🌐 **Five boards, one schema** — Remotive, Arbeitnow, Jobicy, Himalayas and Working Nomads normalized into identical fields.
- 🎚️ **Pick your sources** — the `sources` array lets you pull from all five or just the boards you care about.
- 🔁 **Cross-board de-duplication** — the same job posted to multiple boards is collapsed by apply URL, so no repeats.
- 🔍 **Keyword filter** — `search` does a case-insensitive match across title, description, tags and category.
- 🏷️ **Rich fields** — captures `seniority`, `jobType`, `salary` (where the board provides it), `companyLogo` and cleaned-up `description`.
- ⚡ **Fast, browser-free HTTP** — public JSON APIs only, no headless browser, no login.
- 🎯 **Per-board caps** — `maxItemsPerSource` keeps runs balanced across boards.

### What you get
Every job is normalized into one clean JSON record:

```json
{
  "source": "remotive",
  "title": "Senior Python Engineer",
  "company": "Acme Remote Inc.",
  "companyLogo": "https://remotive.com/logo/acme.png",
  "category": "Software Development",
  "jobType": "full_time",
  "seniority": null,
  "location": "Worldwide",
  "salary": "$120k - $150k",
  "tags": ["python", "django", "aws"],
  "url": "https://remotive.com/remote-jobs/software-dev/senior-python-engineer",
  "postedAt": "2026-07-20T09:00:00.000Z",
  "description": "We are looking for a senior Python engineer to join our fully remote team..."
}
````

### Input

```json
{
  "sources": ["remotive", "arbeitnow", "jobicy", "himalayas", "workingnomads"],
  "search": "python",
  "maxItemsPerSource": 100,
  "proxyConfiguration": { "useApifyProxy": false }
}
```

| Field | Description |
| --- | --- |
| `sources` | Which boards to pull from: `remotive`, `arbeitnow`, `jobicy`, `himalayas`, `workingnomads`. |
| `search` | Case-insensitive keyword filter on title, description, tags and category. Leave empty for all jobs. |
| `maxItemsPerSource` | Cap jobs per board (0 = all available). |
| `proxyConfiguration` | Optional. These public APIs work without a proxy. |

### Use cases

- Populate a remote-jobs board with fresh listings from five sources at once.
- Build a filtered feed (e.g. only "designer" or "marketing" roles) across boards.
- Track remote hiring trends by category, seniority and job type.
- Feed a talent-sourcing or newsletter pipeline with de-duplicated openings.

### Pricing

Pay-per-event: you're billed a small amount per run and per item scraped — you only pay for what you get. See the **Pricing** tab for current rates.

### Notes

This Actor reads the public job-board APIs of Remotive, Arbeitnow, Jobicy, Himalayas and Working Nomads. It is an independent tool and is not affiliated with, endorsed by, or sponsored by any of these services; all names and trademarks belong to their respective owners.

# Actor input Schema

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

Which boards to pull from.

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

Case-insensitive filter on title, description, tags and category (e.g. "python", "designer", "marketing"). Leave empty for all jobs.

## `maxItemsPerSource` (type: `integer`):

Cap jobs per board (0 = all available).

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

Optional. These public APIs work without a proxy.

## Actor input object example

```json
{
  "sources": [
    "remotive",
    "arbeitnow",
    "jobicy",
    "himalayas",
    "workingnomads"
  ],
  "maxItemsPerSource": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/remote-jobs-aggregator").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/remote-jobs-aggregator").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 '{}' |
apify call hipersoft/remote-jobs-aggregator --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Remote Jobs Aggregator — 5 Job Boards in One",
        "description": "Aggregate remote jobs from 5 boards (Remotive, Arbeitnow, Jobicy, Himalayas, Working Nomads) into one clean, de-duplicated dataset: title, company, category, job type, seniority, location, salary, tags, posted date, apply link and description. Fast clean HTTP, no login. Optional keyword filter.",
        "version": "1.0",
        "x-build-id": "ULMKkJB1Xj4mxcpBI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/hipersoft~remote-jobs-aggregator/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-hipersoft-remote-jobs-aggregator",
                "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/hipersoft~remote-jobs-aggregator/runs": {
            "post": {
                "operationId": "runs-sync-hipersoft-remote-jobs-aggregator",
                "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/hipersoft~remote-jobs-aggregator/run-sync": {
            "post": {
                "operationId": "run-sync-hipersoft-remote-jobs-aggregator",
                "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": {
                    "sources": {
                        "title": "Job boards",
                        "type": "array",
                        "description": "Which boards to pull from.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "remotive",
                                "arbeitnow",
                                "jobicy",
                                "himalayas",
                                "workingnomads"
                            ],
                            "enumTitles": [
                                "Remotive",
                                "Arbeitnow",
                                "Jobicy",
                                "Himalayas",
                                "Working Nomads"
                            ]
                        },
                        "default": [
                            "remotive",
                            "arbeitnow",
                            "jobicy",
                            "himalayas",
                            "workingnomads"
                        ]
                    },
                    "search": {
                        "title": "Keyword filter (optional)",
                        "type": "string",
                        "description": "Case-insensitive filter on title, description, tags and category (e.g. \"python\", \"designer\", \"marketing\"). Leave empty for all jobs."
                    },
                    "maxItemsPerSource": {
                        "title": "Max jobs per board",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Cap jobs per board (0 = all available).",
                        "default": 0
                    },
                    "proxyConfiguration": {
                        "title": "Proxy (optional)",
                        "type": "object",
                        "description": "Optional. These public APIs work without a proxy.",
                        "default": {
                            "useApifyProxy": false
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
