{ "openapi": "3.0.1", "info": { "title": "Remote Jobs Aggregator API: RemoteOK, WeWorkRemotely, Jobicy", "description": "Remote jobs from RemoteOK, We Work Remotely and Jobicy in one clean list, read from their official feeds and APIs, merged without duplicates. Every row names its source and links back to the original job. Pay per job, no personal data.", "version": "1.0", "x-build-id": "Gi7a4jz7hJEjnwTLZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rowcraft~remote-jobs-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rowcraft-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/rowcraft~remote-jobs-aggregator/runs": { "post": { "operationId": "runs-sync-rowcraft-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/rowcraft~remote-jobs-aggregator/run-sync": { "post": { "operationId": "run-sync-rowcraft-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": "Keep jobs that mention any of these words in the title, tags or description, for example \"python\", \"react\", \"customer success\". Whole words, not case-sensitive. Leave empty for all jobs.", "items": { "type": "string" } }, "sources": { "title": "Job boards", "type": "array", "description": "Which boards to read. All three by default; the same job listed on more than one board is delivered once, with the other boards named in alsoListedOn.", "items": { "type": "string", "enum": [ "remoteok", "jobicy", "weworkremotely" ], "enumTitles": [ "Remote OK", "Jobicy", "We Work Remotely" ] }, "default": [ "remoteok", "jobicy", "weworkremotely" ] }, "category": { "title": "Category", "enum": [ "all", "software-development", "design", "marketing", "sales", "customer-support", "product", "data", "devops-sysadmin", "finance-legal", "hr", "writing" ], "type": "string", "description": "One category for the three boards: Jobicy and We Work Remotely filter by their own categories, Remote OK by words in the title and its tags (see the README for the exact map). All = no category filter.", "default": "all" }, "postedWithinDays": { "title": "Posted within the last (days)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only jobs posted in this many days. Jobicy keeps 7 days at most, so a longer window adds jobs from Remote OK and We Work Remotely only.", "default": 7 }, "maxItems": { "title": "Maximum job ads", "minimum": 0, "type": "integer", "description": "Stop after this many jobs, newest first. 0 = all matching jobs.", "default": 500 }, "excludeKeywords": { "title": "Exclude title words", "type": "array", "description": "Drop jobs whose title or tags contain any of these words, for example \"senior\", \"intern\", \"manager\".", "items": { "type": "string" } }, "locationContains": { "title": "Location contains", "type": "array", "description": "Keep jobs whose location text contains one of these, for example \"Worldwide\", \"Europe\", \"USA\", \"Germany\". The text is what each board states; Remote OK leaves it empty on many jobs, which never match.", "items": { "type": "string" } }, "salaryOnly": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only jobs that publish a salary or pay range.", "default": false }, "includeDescription": { "title": "Include the job description", "type": "boolean", "description": "Plain-text description written by the employer, e-mails and phones masked, at most 20,000 characters. Turn off for smaller rows.", "default": true }, "countOnly": { "title": "Count only (free check)", "type": "boolean", "description": "Only count how many rows match your filters and estimate the cost at your price tier. Nothing is delivered and nothing is charged apart from the start event. Turn it off to get the data.", "default": false }, "onlyNew": { "title": "Only new rows since the last run", "type": "boolean", "description": "Remember the rows already delivered to you (in a key-value store in your Apify account) and deliver only rows that appeared since the last run with the same state key. The first run delivers everything that matches; later runs cost only the new rows. Ideal for schedules.", "default": false }, "stateName": { "title": "State name", "type": "string", "description": "Name of the memory used by \"Only new rows\". Use a different name for each schedule or search (for example `stockholm-python`) so they do not share one memory.", "default": "default" }, "notifyUrl": { "title": "Notify this URL when the run ends", "type": "string", "description": "A webhook address that receives one JSON POST with the number of new rows and links to the dataset: a Slack or Discord incoming webhook, a Make, n8n or Zapier catch hook, or your own endpoint. The message is also in the `text` (Slack) and `content` (Discord) fields." }, "notifyWhenEmpty": { "title": "Notify also when there are no new rows", "type": "boolean", "description": "By default the notification is sent only when at least one row was delivered.", "default": false }, "requestIntervalMs": { "title": "Delay between requests (ms)", "minimum": 1000, "maximum": 10000, "type": "integer", "description": "Default and minimum 1000 ms (one request per second; Remote OK asks for a 1-second Crawl-delay). A normal run sends 5 to 20 requests.", "default": 1000 } } }, "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 } } } } } } } } } }