{ "openapi": "3.0.1", "info": { "title": "RemoteOK Jobs Scraper | Remote Tech Jobs, Salary & Stack", "description": "Scrape the whole RemoteOK board into structured rows: job title, company, salary range, tech stack, location and a link to the original posting. Reads RemoteOK's public JSON feed - no browser, no proxy, no login - so a full run takes seconds. Filter by tech stack, category, region or minimum salary.", "version": "1.0", "x-build-id": "0d6vzbghRvoWWytLI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tqm~remoteok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tqm-remoteok-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/tqm~remoteok-scraper/runs": { "post": { "operationId": "runs-sync-tqm-remoteok-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/tqm~remoteok-scraper/run-sync": { "post": { "operationId": "run-sync-tqm-remoteok-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": { "maxJobs": { "title": "Maximum Jobs to Scrape", "minimum": 10, "maximum": 100, "type": "integer", "description": "Maximum postings to return. RemoteOK's public feed is a single page of roughly 100 live postings, so that is the real ceiling, asking for more cannot return more.", "default": 100 }, "techStackFilter": { "title": "Tech Stack Filter (Optional)", "type": "array", "description": "Only return jobs mentioning these technologies", "default": [], "items": { "type": "string" } }, "categories": { "title": "Job Categories", "type": "array", "description": "Restrict to RemoteOK's own category labels. The only values that exist are: dev, design, sales, marketing, support, admin. Anything else matches nothing. Measured on a live 99-row board: dev 29, marketing 27, design 27, sales 2, and 14 postings carry NO category at all. Rows with no category are REJECTED by this filter (they cannot satisfy it), and they report separately as categories_uncategorised if a run empties out.", "default": [], "items": { "type": "string" } }, "minSalary": { "title": "Minimum Salary (USD)", "type": "integer", "description": "Filter jobs with salary below this amount", "default": 0 }, "regions": { "title": "Regions (Optional)", "type": "array", "description": "Case-insensitive SUBSTRING match against the posting's location text. That text is free-form and written by the employer, there is no region taxonomy behind this. Measured on a live 99-row board: \"United States\" keeps 8, \"Remote\" 34, \"US\" 7, while \"Europe\", \"Asia\", \"Germany\", \"Anywhere\" and \"Worldwide\" keep ZERO. Use a string you expect to see written in the posting, and expect small numbers. Left empty on purpose: stacked on top of a category this filter empties a run. Measured live, categories [dev] keeps 23 and regions [United States] keeps 6, but the two together keep NOTHING.", "default": [], "items": { "type": "string" } }, "failOnZeroResults": { "title": "Fail the run if no jobs are returned", "type": "boolean", "description": "When on (default), a run that finds no postings FAILS with a message explaining why: too-narrow filters, an empty feed, or a change in RemoteOK's data format. Turn it off if you run this on a schedule and want quiet runs to stay green.", "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 }, "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 } } } } } } } } } }