{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Scraper $2/1K — RemoteOK, Remotive, WWR, Himalayas", "description": "4 remote job boards in one run: RemoteOK, Remotive, WeWorkRemotely, Himalayas. $2/1,000 jobs — cheapest multi-board aggregator. Deduplicated JSON with title, company, salary, apply URL. Delta mode bills each posting once; webhook delivery built in. Made for job-alert bots and hiring research.", "version": "0.1", "x-build-id": "3lH2UWLdF5VyFjTbj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-agent~remote-boards-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-agent-remote-boards-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/nomad-agent~remote-boards-scraper/runs": { "post": { "operationId": "runs-sync-nomad-agent-remote-boards-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/nomad-agent~remote-boards-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-agent-remote-boards-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": { "keyword": { "title": "Keyword filter", "type": "string", "description": "Optional case-insensitive filter, matched against each listing's title, company and category (not its tags or description — the boards' tag lists are company-wide, so matching them returns unrelated roles). Pass several terms separated by commas to match ANY of them — e.g. \"machine learning, ml engineer, data scientist\". Hyphens and spaces are interchangeable. Leave empty to return all listings." }, "titleExclude": { "title": "Title must NOT contain", "type": "array", "description": "Skip listings whose title or company contains any of these case-insensitive terms. Exclusion twin of the keyword filter above.", "default": [], "items": { "type": "string" } }, "postedSince": { "title": "Posted within last N days", "type": "integer", "description": "Only return listings posted within this many days (values outside 0–365 are clamped). Applied client-side after fetching, since none of the 4 source boards support a server-side date filter — postedAt is parsed per source and compared here. Set 0 (default) to disable and return all fetched listings regardless of age.", "default": 0 }, "enableRemoteOK": { "title": "Include RemoteOK", "type": "boolean", "description": "Scrape listings from RemoteOK.", "default": true }, "enableRemotive": { "title": "Include Remotive", "type": "boolean", "description": "Scrape listings from Remotive.", "default": true }, "enableWeWorkRemotely": { "title": "Include WeWorkRemotely", "type": "boolean", "description": "Scrape tech/programming listings from WeWorkRemotely (Full-Stack, Back-End, Front-End, DevOps/SysAdmin).", "default": true }, "enableHimalayas": { "title": "Include Himalayas", "type": "boolean", "description": "Scrape listings from Himalayas (himalayas.app) via its public jobs API. Himalayas exposes numeric salary ranges (min/max/currency) like RemoteOK, plus company logo and employment type.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Delta mode. Remember every listing emitted by previous runs (by deduplicated identity, persisted in a named key-value store) and return ONLY listings not seen before. Great for scheduled runs feeding a job-alert bot — you pay for and receive each posting once. Leave off to return the full current feed every run.", "default": false }, "maxItemsPerSource": { "title": "Max items per source", "type": "integer", "description": "Maximum number of listings to return from each enabled board (values above 500 are clamped to 500). Each item returned is a billed dataset result — raising this increases cost. Set 0 for no limit (not recommended; the 4 source boards can each return hundreds of live listings per run).", "default": 50 }, "maxItems": { "title": "Max items total", "type": "integer", "description": "Hard cap on the total number of listings returned across all boards (values above 2000 are clamped to 2000). Each item returned is a billed dataset result — raising this increases cost. Set 0 for no limit (not recommended).", "default": 150 }, "cacheTtlSeconds": { "title": "Cache TTL (seconds)", "type": "integer", "description": "Reuse a fetch from this many seconds ago instead of hitting the source board again on rapid re-runs. Set 0 to always fetch live. Negative values are treated as 0.", "default": 1800 }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "Optional HTTPS endpoint. When set, the run POSTs its listings to this URL in batches of 50 as JSON ({items, offset, count, total}) after writing them to the dataset. Delivery is best-effort: a webhook failure is logged but never fails the run." }, "webhookSecret": { "title": "Webhook secret (optional)", "type": "string", "description": "Optional shared secret sent with each webhook POST as the X-Webhook-Secret header so your endpoint can verify the caller. Only used when Webhook URL is set." } } }, "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 } } } } } } } } } }