# Remote Jobs Scraper - RemoteOK, We Work Remotely & Himalayas (`feedforge/remote-jobs-scraper`) Actor Scrape remote job listings from four job boards at once. Returns titles, companies, salaries, locations and full descriptions as clean JSON, CSV or Excel. - **URL**: https://apify.com/feedforge/remote-jobs-scraper.md - **Developed by:** [Dominik](https://apify.com/feedforge) (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 $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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. 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 Scraper — RemoteOK, We Work Remotely, Himalayas & Arbeitnow Pull every current remote job from **four job boards in one run**, de-duplicated and returned as clean JSON, CSV or Excel. Most job scrapers cover a single board. Roles get cross-posted, so a single board gives you an incomplete picture and four separate scrapers give you the same job three times. This one merges all four and collapses the duplicates for you. ### What you can do with it - **Build a job board or aggregator** — a ready-made, refreshed feed of remote roles you can publish straight to your own site. - **Recruiting and talent research** — see who is hiring for which roles, and at what salary, across the remote market. - **Salary benchmarking** — thousands of listings carry structured min/max salary and currency. - **Lead generation** — companies actively hiring are companies actively spending. Filter by role to find them. - **Market and competitor tracking** — watch a named list of companies and see every role they open. - **Feed an AI agent or RAG pipeline** — clean, flat records with full description text, no HTML wrangling required. ### Example output ```json { "source": "himalayas", "title": "Senior Backend Engineer", "companyName": "Acme Cloud", "companyLogo": "https://…/logo.png", "location": "United States, Canada", "locationRestrictions": ["United States", "Canada"], "timezoneRestrictions": ["EST", "PST"], "employmentType": "Full Time", "seniority": "Senior", "categories": ["Software Engineering"], "salaryMin": 150000, "salaryMax": 190000, "salaryCurrency": "USD", "salaryPeriod": "year", "publishedAt": "2026-07-26T09:33:11+00:00", "url": "https://himalayas.app/jobs/acme-cloud-senior-backend-engineer", "applyUrl": "https://acme.example/careers/123", "descriptionText": "We are looking for a senior backend engineer…", "alsoOn": ["remoteok"] } ```` `alsoOn` tells you which other boards carried the same role — useful for spotting how widely a company is advertising. ### Input Everything is optional. Run it with no configuration at all and you get the 100 most recent remote jobs across all four boards. | Field | Type | Description | |---|---|---| | `search` | string | Keywords matched against title, company and description. `"python, backend"` matches either term. | | `sources` | array | Which boards to use. Defaults to all four. | | `maxItems` | integer | How many jobs to return. Default 100. | | `postedWithinDays` | integer | Only jobs published in the last N days. | | `minSalary` | integer | Only jobs advertising at least this much. | | `employmentType` | string | e.g. `Full-Time`, `Contract`. | | `seniority` | string | e.g. `Senior`, `Junior`, `Lead`. | | `companies` | array | Restrict to an exact list of company names. | | `deduplicate` | boolean | Merge roles cross-posted to several boards. Default `true`. | | `includeDescription` | boolean | Include full description text and HTML. Default `true`. | #### Find senior Python roles paying over $120k, posted this week ```json { "search": "python", "seniority": "senior", "minSalary": 120000, "postedWithinDays": 7, "maxItems": 200 } ``` #### Track specific companies ```json { "companies": ["GitLab", "Automattic", "Zapier"], "includeDescription": false } ``` ### Output fields `source`, `sourceJobId`, `url`, `applyUrl`, `title`, `companyName`, `companyLogo`, `location`, `isRemote`, `locationRestrictions`, `timezoneRestrictions`, `employmentType`, `seniority`, `categories`, `tags`, `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod`, `publishedAt`, `expiresAt`, `descriptionText`, `descriptionHtml`, `alsoOn`, `scrapedAt` Not every board publishes every field — salary in particular is most complete on Himalayas. Fields that a board does not provide come back as `null` rather than being omitted, so your schema stays stable. ### Pricing Pay per result. You are charged only for jobs actually delivered — a run that matches nothing costs nothing. ### Keeping it fresh Use Apify **Schedules** to run this daily and your dataset stays current without you touching it. Pair with a webhook to push new listings straight into your database, Google Sheet or Slack channel. ### Notes on sources All four boards are read through their own public APIs or RSS feeds — no logins, no bot circumvention — which is why this actor is stable and does not silently break. If one board is temporarily unavailable the run continues with the others and notes which was skipped. Data from RemoteOK is provided under their API terms, which ask that RemoteOK is credited as the source where listings are republished. The canonical `url` is included on every record so you can attribute correctly. # Actor input Schema ## `search` (type: `string`): Filter jobs by keyword. Matches job title, company and description. Space or comma separated, e.g. 'python, backend'. Leave empty to get every current remote job. ## `sources` (type: `array`): Which boards to pull from. All four by default. ## `maxItems` (type: `integer`): How many jobs to return. You are only charged for jobs actually delivered. ## `postedWithinDays` (type: `integer`): Only return jobs published in the last N days. Leave empty for no date limit. ## `minSalary` (type: `integer`): Only return jobs whose advertised salary reaches this figure. Jobs with no published salary are excluded when this is set. ## `employmentType` (type: `string`): Match against the employment type, e.g. 'Full-Time', 'Contract'. ## `seniority` (type: `string`): Match against seniority or job title, e.g. 'Senior', 'Junior', 'Lead'. ## `companies` (type: `array`): Only return jobs from these exact company names. Leave empty for all companies. ## `deduplicate` (type: `boolean`): The same role is often posted to several boards. When enabled, duplicates are merged and the boards it appeared on are listed in 'alsoOn'. ## `includeDescription` (type: `boolean`): Include the full job description text and HTML. Turn off for a much smaller dataset. ## Actor input object example ```json { "search": "python developer", "sources": [ "remoteok", "himalayas", "weworkremotely", "arbeitnow" ], "maxItems": 100, "deduplicate": true, "includeDescription": true } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "search": "python developer" }; // Run the Actor and wait for it to finish const run = await client.actor("feedforge/remote-jobs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "search": "python developer" } # Run the Actor and wait for it to finish run = client.actor("feedforge/remote-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "search": "python developer" }' | apify call feedforge/remote-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=feedforge/remote-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Remote Jobs Scraper - RemoteOK, We Work Remotely & Himalayas", "description": "Scrape remote job listings from four job boards at once. Returns titles, companies, salaries, locations and full descriptions as clean JSON, CSV or Excel.", "version": "0.1", "x-build-id": "LbUM06Z9Lyhig8cR9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/feedforge~remote-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-feedforge-remote-jobs-scraper", "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/feedforge~remote-jobs-scraper/runs": { "post": { "operationId": "runs-sync-feedforge-remote-jobs-scraper", "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/feedforge~remote-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-feedforge-remote-jobs-scraper", "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 keywords", "type": "string", "description": "Filter jobs by keyword. Matches job title, company and description. Space or comma separated, e.g. 'python, backend'. Leave empty to get every current remote job." }, "sources": { "title": "Job boards", "type": "array", "description": "Which boards to pull from. All four by default.", "items": { "type": "string", "enum": [ "remoteok", "himalayas", "weworkremotely", "arbeitnow" ], "enumTitles": [ "RemoteOK", "Himalayas", "We Work Remotely", "Arbeitnow" ] }, "default": [ "remoteok", "himalayas", "weworkremotely", "arbeitnow" ] }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many jobs to return. You are only charged for jobs actually delivered.", "default": 100 }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only return jobs published in the last N days. Leave empty for no date limit." }, "minSalary": { "title": "Minimum salary", "minimum": 0, "type": "integer", "description": "Only return jobs whose advertised salary reaches this figure. Jobs with no published salary are excluded when this is set." }, "employmentType": { "title": "Employment type", "type": "string", "description": "Match against the employment type, e.g. 'Full-Time', 'Contract'." }, "seniority": { "title": "Seniority", "type": "string", "description": "Match against seniority or job title, e.g. 'Senior', 'Junior', 'Lead'." }, "companies": { "title": "Companies", "type": "array", "description": "Only return jobs from these exact company names. Leave empty for all companies.", "items": { "type": "string" } }, "deduplicate": { "title": "Remove duplicate postings", "type": "boolean", "description": "The same role is often posted to several boards. When enabled, duplicates are merged and the boards it appeared on are listed in 'alsoOn'.", "default": true }, "includeDescription": { "title": "Include full descriptions", "type": "boolean", "description": "Include the full job description text and HTML. Turn off for a much smaller dataset.", "default": true } } }, "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 } } } } } } } } } } ```