{
  "openapi": "3.0.1",
  "info": {
    "title": "Remote Jobs Aggregator: Remote OK + Jobicy in One List",
    "description": "The newest remote jobs from Remote OK and Jobicy in one deduplicated list, with salary, location, tags and the apply link. Filter by keyword, location, minimum salary and posting date, or get only new jobs on a schedule. $0.001 per job ($1 per 1,000); duplicates and filtered jobs are free.",
    "version": "1.5",
    "x-build-id": "ahMcRxOeafgrHKsLN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fecklesspleb~remote-jobs-aggregator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fecklesspleb-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/fecklesspleb~remote-jobs-aggregator/runs": {
      "post": {
        "operationId": "runs-sync-fecklesspleb-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/fecklesspleb~remote-jobs-aggregator/run-sync": {
      "post": {
        "operationId": "run-sync-fecklesspleb-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": {
          "sources": {
            "title": "Sources",
            "type": "array",
            "description": "Which job boards to include. Leave empty for all (Remote OK and Jobicy). We Work Remotely (weworkremotely) is no longer read, because its API terms forbid building a job search service: if a saved input still lists it, the run ignores it, writes one free status item, and does not fail.",
            "items": {
              "type": "string",
              "enum": [
                "remoteok",
                "weworkremotely",
                "jobicy"
              ],
              "enumTitles": [
                "Remote OK",
                "We Work Remotely (no longer read)",
                "Jobicy"
              ]
            }
          },
          "keywords": {
            "title": "Keywords (any)",
            "type": "array",
            "description": "Keep jobs whose title, tags or category contain at least one of these strings, e.g. [\"python\", \"data engineer\"]. Case-insensitive substring match, so \"go\" also matches \"Google\". Leave empty to keep all.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude title keywords",
            "type": "array",
            "description": "Drop jobs whose title contains any of these strings (case-insensitive substring, title only), e.g. [\"senior\", \"manager\"].",
            "items": {
              "type": "string"
            }
          },
          "searchInDescription": {
            "title": "Match keywords in description too",
            "type": "boolean",
            "description": "Also match keywords against the full job description text. Default false. Works even when Include description is off.",
            "default": false
          },
          "locations": {
            "title": "Locations (any)",
            "type": "array",
            "description": "Keep jobs whose location text contains one of these strings (case-insensitive substring), e.g. [\"USA\", \"Europe\", \"Anywhere\"]. Boards write locations freely (\"USA Only\", \"North America Only\"); jobs with no location are given \"Remote\".",
            "items": {
              "type": "string"
            }
          },
          "requireSalary": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Keep only jobs that state pay: from the board, or a range parsed from the description (salarySource \"source\" or \"description\"). Default false.",
            "default": false
          },
          "minSalaryUsd": {
            "title": "Minimum yearly salary (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum yearly pay in USD, e.g. 100000. Compares salaryMax (or salaryMin if there is no max), converted with rough fixed rates (EUR, GBP, CAD, AUD) and period multipliers (hour x2080, day x260, week x52, month x12). Jobs without a salary, or in another currency, are dropped when this is set."
          },
          "postedWithinDays": {
            "title": "Posted within last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Keep only jobs posted in the last N days (1 to 365), e.g. 7. Jobs without a posting date are kept."
          },
          "wwrCategories": {
            "title": "We Work Remotely categories",
            "type": "array",
            "description": "No longer used. We Work Remotely is not read (its API terms forbid building a job search service). A value here has no effect. Kept so old saved inputs still start.",
            "items": {
              "type": "string",
              "enum": [
                "programming",
                "full-stack",
                "front-end",
                "back-end",
                "devops",
                "design",
                "product",
                "customer-support",
                "sales-marketing",
                "management-finance",
                "other"
              ]
            }
          },
          "jobicyGeo": {
            "title": "Jobicy region",
            "type": "string",
            "description": "Optional Jobicy region, passed to Jobicy's API as geo, e.g. \"usa\", \"europe\", \"canada\". No effect on other boards. Jobicy is read at most once per hour (its fair-use rule); a run within an hour of the last Jobicy pass skips Jobicy and says so in RUN_SUMMARY."
          },
          "jobicyIndustry": {
            "title": "Jobicy industry",
            "type": "string",
            "description": "Optional Jobicy industry, passed to Jobicy's API as industry, e.g. \"dev\", \"marketing\", \"design-multimedia\". No effect on other boards."
          },
          "jobicyTag": {
            "title": "Jobicy tag",
            "type": "string",
            "description": "Optional Jobicy keyword, passed unchanged to Jobicy's API as tag. Jobicy's API docs describe tag as a keyword search: their API page says it is applied to the job title, their OpenAPI spec (2.2.19) says across available job content and accepts 3-50 characters (ASCII). This Actor does not check it or filter on it. Empty = not sent. No effect on other boards."
          },
          "dedupe": {
            "title": "Merge duplicates across boards",
            "type": "boolean",
            "description": "The same job is often posted on several boards. Keep one record (newest) and list the other copies in 'alsoListedOn'.",
            "default": true
          },
          "onlyNewJobs": {
            "title": "Only new jobs",
            "type": "boolean",
            "description": "Return only jobs not returned by an earlier run with this option on, so scheduled runs give a clean feed and you pay only for new jobs. Default false. Seen jobs (by source ID and by company + title) are kept for 120 days in the state store.",
            "default": false
          },
          "stateStoreName": {
            "title": "State store name",
            "type": "string",
            "description": "Named key-value store for 'Only new jobs' and the Jobicy hourly limit.",
            "default": "remote-jobs-aggregator-state"
          },
          "includeDescription": {
            "title": "Include description",
            "type": "boolean",
            "description": "Include the full job description (descriptionText, descriptionHtml or both, see Description format). Default false to keep rows small.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "html",
              "both"
            ],
            "type": "string",
            "description": "Plain text, HTML, or both.",
            "default": "text"
          },
          "redactContacts": {
            "title": "Remove contact details from descriptions",
            "type": "boolean",
            "description": "Replace personal e-mail addresses (role mailboxes such as jobs@ or careers@ stay), phone numbers and 'Recruiter: <name>' lines in job descriptions with placeholders. On by default. Only matters when Include descriptions is on.",
            "default": true
          },
          "maxTotalJobs": {
            "title": "Max jobs in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many jobs. Default 8, so a run with no input is small and fast. 0 means no limit. The run also stops at your 'Maximum cost per run'.",
            "default": 8
          },
          "datasetId": {
            "title": "Chain: previous dataset ID",
            "type": "string",
            "description": "ID of a dataset from an earlier run of a fecklesspleb jobs Actor (ats-jobs-scraper, workday-jobs-scraper, career-site-jobs-feed or remote-jobs-aggregator). Its job items are read before any job site is fetched. A job of this run that is already in it is dropped before it is pushed, so it is not charged. This field asks Apify for read-only access to this one dataset, so it also works while the Actor runs with limited permissions. When used as an Apify integration target, put {{resource.defaultDatasetId}} here; if the field is empty, payload.resource.defaultDatasetId is tried, but only a dataset given in this field is granted to the run. If the dataset cannot be read, the run stops before fetching anything."
          },
          "datasetMode": {
            "title": "Chain: merge or exclude",
            "enum": [
              "merge",
              "exclude"
            ],
            "type": "string",
            "description": "Used only with a previous dataset ID. <b>Merge</b> (used when empty): the previous dataset's job items are first copied into this run's dataset (free, not charged; status items are not copied), then this run's new jobs are added, so this dataset is the whole deduplicated list. <b>Exclude</b>: nothing is copied; this dataset has only the jobs that were not in the previous one."
          },
          "datasetMatchBy": {
            "title": "Chain: what counts as the same job",
            "enum": [
              "uid",
              "uidOrCrossKey"
            ],
            "type": "string",
            "description": "Used only with a previous dataset ID. <b>Job ID</b> (used when empty): the same uid (same posting on the same board; uids are the same in all fecklesspleb jobs Actors). <b>Job ID or same company + title</b>: also the same crossSourceKey (company without legal form + title, no location), so the same job on an ATS board and on a remote board is kept once. A company that posts one title in several cities gets one key for all of them."
          },
          "suiteOutput": {
            "title": "Shared jobs-suite field order",
            "type": "boolean",
            "description": "Off (as before): each job has this Actor's own fields in its own order. On: every job has all shared jobs-suite fields in one order (fields this Actor does not have are null or empty lists), followed by this Actor's extra fields, so datasets from different fecklesspleb jobs Actors line up column by column. Values are never changed."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}