{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Scraper - RemoteOK, Remotive & Himalayas", "description": "One deduplicated feed of remote jobs from RemoteOK, Remotive and Himalayas. USD-normalised salaries, contact details stripped, incremental mode. Pay per job row.", "version": "0.1", "x-build-id": "tx9xkSB9ncfSc1UVF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/borasipahi~remote-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-borasipahi-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/borasipahi~remote-jobs-scraper/runs": { "post": { "operationId": "runs-sync-borasipahi-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/borasipahi~remote-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-borasipahi-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": { "sources": { "title": "Sources", "type": "array", "description": "Job boards to pull from. All three are public JSON APIs; no login is used.", "items": { "type": "string", "enum": [ "remoteok", "remotive", "himalayas" ], "enumTitles": [ "RemoteOK", "Remotive", "Himalayas" ] }, "default": [ "remoteok", "remotive", "himalayas" ] }, "searchQuery": { "title": "Search query", "type": "string", "description": "Case-insensitive keywords matched against title, company, tags and description. Separate alternatives with a comma, e.g. \"react, vue\"." }, "categories": { "title": "Categories", "type": "array", "description": "Keep only jobs whose category or tags contain any of these words, e.g. [\"engineering\", \"design\", \"sales\"].", "default": [], "items": { "type": "string" } }, "seniority": { "title": "Seniority", "type": "array", "description": "Keep only jobs at these levels. Inferred from the title and from the board's own field when it has one.", "items": { "type": "string", "enum": [ "intern", "junior", "mid", "senior", "lead", "manager", "director", "executive" ] }, "default": [] }, "employmentType": { "title": "Employment type", "type": "array", "description": "Keep only these employment types.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "internship" ] }, "default": [] }, "minSalary": { "title": "Minimum annual salary (USD)", "minimum": 0, "type": "integer", "description": "Keep only jobs whose USD-annualised salary is at least this. Jobs with no salary are dropped when this is set." }, "locationRestrictions": { "title": "Location restrictions", "type": "array", "description": "Keep only jobs open to these regions or countries, matched as substrings, e.g. [\"Worldwide\", \"Europe\", \"United States\"]. Jobs with no restriction are always kept.", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "type": "integer", "description": "Keep only jobs published in the last N days. Himalayas has 100k+ historic jobs; this bounds the crawl.", "default": 30 }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "type": "integer", "description": "Stop after this many jobs have been saved. Bounds your cost.", "default": 500 }, "deduplicate": { "title": "Deduplicate across boards", "type": "boolean", "description": "The same job is often posted on all three boards. When on, later copies are not saved and the saved copy lists them in alsoOn, so you pay once per job.", "default": true }, "stripContactDetails": { "title": "Strip contact details", "type": "boolean", "description": "Remove e-mail addresses and phone numbers that recruiters paste into descriptions. Keeps the output free of personal data.", "default": true }, "includeFullDescription": { "title": "Include full description", "type": "boolean", "description": "Include descriptionHtml and descriptionText. Off gives a compact feed with excerpt only. No extra charge either way.", "default": true }, "incremental": { "title": "Incremental mode", "type": "boolean", "description": "Remember every job already delivered (in a named key-value store) and skip it on the next run. Use with a schedule to get only new jobs.", "default": false }, "incrementalStoreName": { "title": "Incremental store name", "type": "string", "description": "Name of the key-value store that holds seen job ids for incremental mode.", "default": "remote-jobs-scraper-seen" } } }, "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 } } } } } } } } } }