{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Aggregator & Job Alerts - RemoteOK, Himalayas, WWR", "description": "Scrape remote job listings from RemoteOK, Himalayas, Jobicy and We Work Remotely in one run. Deduplicated, filterable by keyword, salary, location and date. Turn on job alerts and run on a schedule to get only new listings each time, billed once each.", "version": "0.1", "x-build-id": "hOJCdght6MU4PLmBc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lukehunter~remote-jobs-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lukehunter-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/lukehunter~remote-jobs-aggregator/runs": { "post": { "operationId": "runs-sync-lukehunter-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/lukehunter~remote-jobs-aggregator/run-sync": { "post": { "operationId": "run-sync-lukehunter-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Match jobs whose title, tags or description contain ANY of these words (case-insensitive). Leave empty to keep every job from the selected sources.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, tags or description contain ANY of these words (case-insensitive). Leave empty to exclude nothing.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "Which job boards to pull from. Default is all four.", "items": { "type": "string", "enum": [ "remoteok", "himalayas", "jobicy", "wwr" ], "enumTitles": [ "RemoteOK", "Himalayas", "Jobicy", "We Work Remotely" ] }, "default": [ "remoteok", "himalayas", "jobicy", "wwr" ] }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only keep jobs posted within this many days, 1-90. A job whose posting date could not be determined is kept regardless.", "default": 7 }, "locationContains": { "title": "Location contains", "type": "string", "description": "Only keep jobs whose location text contains this (case-insensitive), e.g. \"Europe\" or \"United States\". Ignored if \"Worldwide only\" is on. Leave empty for no location filter." }, "worldwideOnly": { "title": "Worldwide only", "type": "boolean", "description": "Only keep jobs open to applicants anywhere in the world (no country/region restriction stated by the source).", "default": false }, "minSalary": { "title": "Minimum salary", "minimum": 0, "type": "integer", "description": "Only keep jobs whose stated salary (min or max, whichever is higher) meets this figure. Currency-naive: compared as a raw number regardless of the job's currency. Leave empty for no salary filter." }, "includeUnknownSalary": { "title": "Include jobs with no stated salary", "type": "boolean", "description": "When a minimum salary is set, whether to still keep jobs that state no salary at all (most listings don't). Ignored if no minimum salary is set.", "default": true }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of jobs delivered across all sources, 1-1000, default 50. You are charged per delivered job, so this is your cost cap.", "default": 50 }, "includeFullDescription": { "title": "Include full description", "type": "boolean", "description": "By default, descriptionText is truncated to 2000 characters. Turn this on to include the full plain-text description (larger dataset items).", "default": false }, "onlyNewSinceLastRun": { "title": "Job alerts: only new jobs since last run", "type": "boolean", "description": "Turn this on and run the Actor on a schedule to get only jobs you haven't seen before: jobs already delivered on a previous run for the same keywords/sources/filters are skipped and never charged again (cross-posted duplicates are matched by company+title, so a job that moves between boards is still recognised). The first run for a given search delivers everything (it's all new) and remembers it; later runs only deliver what's new since then. Off by default so a one-off run always gets the full current results.", "default": false }, "stateStoreName": { "title": "Job alerts: state store name", "type": "string", "description": "Only used when \"Job alerts\" is on. Name of the key-value store that remembers which jobs this search has already delivered, so it persists across scheduled runs. Leave as the default unless you're running several different alert searches that must not share history — give each its own name in that case. Letters, numbers and hyphens only.", "default": "remote-jobs-aggregator-seen-jobs" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }