{
  "openapi": "3.0.1",
  "info": {
    "title": "New Job Postings Monitor — Hiring Signals & Job Change Alerts",
    "description": "Watch company career pages on a daily schedule and get only what changed: roles opened, closed or edited, plus per-company open counts and hiring velocity. Covers Greenhouse, Lever, Ashby, Workable, Workday and 6 more ATS. Built for sales triggers and recruiting intel.",
    "version": "1.0",
    "x-build-id": "Mf2uEF9dLw6kgaEpg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/insight.solutions~job-postings-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-insight.solutions-job-postings-monitor",
        "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/insight.solutions~job-postings-monitor/runs": {
      "post": {
        "operationId": "runs-sync-insight.solutions-job-postings-monitor",
        "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/insight.solutions~job-postings-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-insight.solutions-job-postings-monitor",
        "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",
        "required": [
          "boards"
        ],
        "properties": {
          "boards": {
            "title": "Career boards to monitor",
            "type": "array",
            "description": "One entry per company. Use `ats:slug` (for example `greenhouse:stripe`, `lever:leverdemo`, `ashby:ramp`) when you know the platform, or just a bare company domain (`stripe.com`) and we will detect the ATS for you. Workday needs the board host and site name: `workday:nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite`.",
            "items": {
              "type": "string"
            }
          },
          "atsPlatforms": {
            "title": "Restrict ATS auto-detection",
            "type": "array",
            "description": "Only relevant for bare-domain inputs. When set, domain auto-detection will only consider these platforms. Leave empty to try all of them.",
            "items": {
              "type": "string",
              "enum": [
                "greenhouse",
                "lever",
                "ashby",
                "workable",
                "recruitee",
                "smartrecruiters",
                "teamtailor",
                "personio",
                "workday",
                "breezy",
                "jazzhr"
              ],
              "enumTitles": [
                "Greenhouse",
                "Lever",
                "Ashby",
                "Workable",
                "Recruitee",
                "SmartRecruiters",
                "Teamtailor",
                "Personio",
                "Workday (beta)",
                "Breezy HR",
                "JazzHR (beta)"
              ]
            },
            "default": []
          },
          "stateStoreName": {
            "title": "State store name",
            "type": "string",
            "description": "Name of the key-value store that holds the previous run's snapshot. The Actor creates it on its first run and reads it back on every run after that — that memory is what makes this a monitor rather than a scraper. Keep one store per watchlist: two schedules sharing a store would each diff against the same snapshot, so the second one stops with a clear message instead of double-reporting. Do not point this at a store you created by hand; a limited-permissions Actor may not read those, and the run would silently restart from a baseline.",
            "default": "job-postings-monitor-state"
          },
          "emitNew": {
            "title": "Emit new postings",
            "type": "boolean",
            "description": "Report roles that appeared since the previous run.",
            "default": true
          },
          "emitClosed": {
            "title": "Emit closed postings",
            "type": "boolean",
            "description": "Report roles that were in the previous snapshot and are gone now.",
            "default": true
          },
          "emitChanged": {
            "title": "Emit changed postings",
            "type": "boolean",
            "description": "Report roles that are still open but were edited. Off by default: edits are noisier and less actionable than openings and closures, and each one is a billable event.",
            "default": false
          },
          "emitUnchanged": {
            "title": "Emit unchanged postings",
            "type": "boolean",
            "description": "Also write one row per role that did not change, so you can reconcile our view of a board against your own. These rows are free — they are never billed as change events — and they carry no job description; for full postings use our Career Site Jobs API Actor. Off by default.",
            "default": false
          },
          "changedFields": {
            "title": "Fields that count as a change",
            "type": "array",
            "description": "Which parts of a posting have to move before it is reported as `changed`. A bare `updatedAt` bump never counts on its own — most ATS platforms touch that timestamp for reasons unrelated to the posting. Selecting `description` makes every run fetch the posting bodies, which is slower.",
            "items": {
              "type": "string",
              "enum": [
                "title",
                "location",
                "salary",
                "description"
              ],
              "enumTitles": [
                "Job title",
                "Location",
                "Salary range",
                "Description body"
              ]
            },
            "default": [
              "title",
              "location",
              "salary"
            ]
          },
          "titleFilter": {
            "title": "Title filter",
            "type": "array",
            "description": "Monitor only roles whose title contains one of these strings (case-insensitive). For example `engineer`, `sales`. Filters decide what is watched, not just what is reported — changing them between runs will look like roles opening and closing.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "locationFilter": {
            "title": "Location filter",
            "type": "array",
            "description": "Monitor only roles whose location contains one of these strings (case-insensitive). For example `Berlin`, `United Kingdom`, `Remote`. Same caveat as the title filter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "firstRunBehavior": {
            "title": "First run behaviour",
            "enum": [
              "baseline-only",
              "emit-all"
            ],
            "type": "string",
            "description": "What to do the first time a board is seen, when there is nothing to compare against. `baseline-only` stores the snapshot and writes just the per-company summary, so you are not billed for a backfill you did not ask for. `emit-all` reports every currently open role as `new`, which is billed per role.",
            "default": "baseline-only"
          },
          "includeDescription": {
            "title": "Include job descriptions",
            "type": "boolean",
            "description": "Include the posting body on new and changed rows. Off by default because a hiring signal rarely needs it and leaving it off makes every run faster. Turned on automatically when `description` is one of your changed fields.",
            "default": false
          },
          "maxJobsPerBoard": {
            "title": "Max jobs per board",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Ceiling on how many postings are read from any single board. Keep this comfortably above the size of the boards you watch: if a board fills the ceiling, the postings beyond it were not read, and unread is not closed — so closed-posting detection is suspended for that board and the summary row is flagged `truncated`.",
            "default": 2000
          },
          "outageGuardThreshold": {
            "title": "Outage guard threshold",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "If a board suddenly returns zero postings and its previous snapshot held more than this many, the run treats it as an ATS outage rather than a mass closure: no `closed` events, the old snapshot is kept, and a diagnostic row explains what happened. Set to 0 to disable the guard — not recommended.",
            "default": 10
          },
          "requestTimeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 5,
            "maximum": 120,
            "type": "integer",
            "description": "Per-HTTP-request timeout. Raise it only if you are monitoring very large Workday boards.",
            "default": 20
          },
          "maxRunSecs": {
            "title": "Run time budget (seconds)",
            "minimum": 30,
            "maximum": 3600,
            "type": "integer",
            "description": "Wall-clock budget for the whole run, so one unresponsive career site cannot hold a scheduled run open until the platform timeout. When it is reached the Actor stops fetching, keeps and bills for everything already delivered, and writes a diagnostic row for each board it never reached — those boards keep their snapshots and are not charged for.",
            "default": 240
          },
          "maxConcurrency": {
            "title": "Max concurrent boards",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many career boards to fetch at the same time. We never send more than one request at a time to the same host.",
            "default": 6
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}