{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Scraper & Aggregator – 6 Boards, Job Alerts", "description": "All remote jobs in one clean, deduplicated JSON feed from official APIs & RSS: Himalayas, Remote OK, Jobicy, Arbeitnow, plus opt-in Remotive and We Work Remotely. Filter by keyword, category, region, salary (annual USD) and date. Only-new mode for daily job alerts.", "version": "0.1", "x-build-id": "JyodpO62J1LjggjUN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gazidev~remote-jobs-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gazidev-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/gazidev~remote-jobs-aggregator/runs": { "post": { "operationId": "runs-sync-gazidev-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/gazidev~remote-jobs-aggregator/run-sync": { "post": { "operationId": "run-sync-gazidev-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": "Job must match at least one keyword (title, company, tags, category or description). Case- and accent-insensitive whole words; add * for prefix match (e.g. `develop*`). Leave empty for all jobs.", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title or company contains any of these words (e.g. `senior`, `sales`).", "default": [], "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Keep jobs in any of these categories. Matches the normalized category (Software Development, Data & AI, DevOps & Infrastructure, Security, QA & Testing, Design, Product, Project & Operations, Marketing, Sales & Business Development, Customer Support, Writing & Content, Finance & Legal, HR & Recruiting, Healthcare, Education, Other) and the source's own category/tags. Partial, case-insensitive.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions / countries you can work from", "type": "array", "description": "Keep jobs open to candidates in any of these places, e.g. `Europe`, `USA`, `UK`, `Canada`, `LATAM`, `APAC`, `Germany`. Region names also match their countries (Europe → Germany, Poland…).", "default": [], "items": { "type": "string" } }, "includeWorldwide": { "title": "Include worldwide / anywhere jobs in region filter", "type": "boolean", "description": "When a region filter is set, also keep jobs open worldwide or with no location restriction.", "default": true }, "minSalaryUsd": { "title": "Minimum salary (USD per year)", "minimum": 0, "type": "integer", "description": "Keep jobs whose top of range, normalized to annual USD (hourly×2080, monthly×12; live ECB FX rates), is at least this. Jobs without a published salary are dropped unless the option below is on." }, "includeJobsWithoutSalary": { "title": "Keep jobs without published salary (with min salary)", "type": "boolean", "description": "Only relevant when a minimum salary is set.", "default": false }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Keep only these types. Leave empty for all.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "temporary", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract / freelance", "Internship", "Temporary", "Volunteer", "Other" ] }, "default": [] }, "postedWithinDays": { "title": "Posted within last N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only jobs published in the last N days. 0 = any age.", "default": 7 }, "sources": { "title": "Sources", "type": "array", "description": "Job boards to include. Remotive and We Work Remotely are opt-in: check their terms before enabling.", "items": { "type": "string", "enum": [ "himalayas", "remoteok", "jobicy", "remotive", "weworkremotely", "arbeitnow" ], "enumTitles": [ "Himalayas", "Remote OK", "Jobicy", "Remotive", "We Work Remotely (RSS)", "Arbeitnow (remote-flagged only)" ] }, "default": [ "himalayas", "remoteok", "jobicy", "arbeitnow" ] }, "onlyNewSinceLastRun": { "title": "Only new jobs since last run (job alerts)", "type": "boolean", "description": "Remember delivered jobs (per search, in a named key-value store) and output + charge only jobs not delivered before — including the same job re-posted on another board. Ideal with a daily/hourly schedule.", "default": false }, "stateKey": { "title": "Alert name (optional)", "type": "string", "description": "Name for the only-new memory. By default it is derived from your filters, so changing filters starts a fresh alert. Set it to keep one memory across filter tweaks, or to run several independent alerts." }, "deduplicate": { "title": "Merge duplicates across boards", "type": "boolean", "description": "Same company + near-identical title on several boards → one record, other boards listed in `also_listed_on`.", "default": true }, "descriptionMode": { "title": "Job description", "enum": [ "none", "snippet", "full" ], "type": "string", "description": "Include a plain-text description: none, a 500-character snippet, or the full text.", "default": "snippet" }, "maxItems": { "title": "Max jobs to output", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of jobs output (and charged) per run, newest first.", "default": 200 }, "maxJobsPerSource": { "title": "Max jobs fetched per source", "minimum": 20, "maximum": 1000, "type": "integer", "description": "Fetch depth for paginated sources (Himalayas, Arbeitnow). Higher = more history, slower run.", "default": 300 } } }, "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 } } } } } } } } } }