{
  "openapi": "3.0.1",
  "info": {
    "title": "ATS Job Board Scraper & Alerts: Greenhouse, Lever, Ashby",
    "description": "Scrape Greenhouse, Lever, Ashby, SmartRecruiters and Workable jobs. Use the new-jobs-only task to export additions since your saved baseline without paying for unchanged job rows. Filter company watchlists or track all hiring changes with optional Slack and Discord alerts.",
    "version": "0.1",
    "x-build-id": "qpYeccwNJuBXC6HOl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/harvestlab~ats-hiring-signal-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-harvestlab-ats-hiring-signal-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/harvestlab~ats-hiring-signal-monitor/runs": {
      "post": {
        "operationId": "runs-sync-harvestlab-ats-hiring-signal-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/harvestlab~ats-hiring-signal-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-harvestlab-ats-hiring-signal-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",
        "properties": {
          "companyNames": {
            "title": "Company names",
            "type": "array",
            "description": "Optional company labels paired with board URLs, domains, or slugs in the same order. Names alone are not a company search or a supported target.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "companyDomains": {
            "title": "Company domains",
            "type": "array",
            "description": "Optional company domains to search for supported public ATS careers links.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "atsBoardUrls": {
            "title": "ATS board URLs",
            "type": "array",
            "description": "Public Greenhouse, Lever, Ashby, SmartRecruiters, or Workable board URLs. This is the most reliable input for a first run.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "atsSlugs": {
            "title": "ATS slugs",
            "type": "array",
            "description": "Optional source:slug values, such as greenhouse:stripe, lever:mistral, ashby:openai, smartrecruiters:boschgroup, or workable:huggingface. Raw slugs are expanded across supported ATS sources.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxCompanies": {
            "title": "Max companies",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of companies or board targets to scan.",
            "default": 25
          },
          "maxJobsPerCompany": {
            "title": "Max jobs per company",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum source jobs read per board before filtering. A snapshot at this cap is incomplete and cannot prove closures or replace a complete watchlist baseline. Maximum 1000.",
            "default": 100
          },
          "maxOutputJobs": {
            "title": "Max output jobs",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum dataset job rows after jobOutputMode and title/location/remote filters; 0 means no output cap. If eligible rows exceed the cap, baseline advancement and alerts are held so omitted changes are not lost. Source fetching is bounded separately by maxJobsPerCompany.",
            "default": 0
          },
          "jobOutputMode": {
            "title": "Job output",
            "enum": [
              "all",
              "changes",
              "new"
            ],
            "type": "string",
            "description": "Dataset selection. all returns matching observed jobs; changes returns proved new, changed, closed and reopened jobs with summaries. new returns additions against retained baseline history; first or unverified comparisons return no jobs. Both incremental modes require watchMode and either watchlistId or a complete previousJobsDatasetId. A native watchlist retains closed-job history and excludes those reopenings from new-only output. Manual dataset history may omit older closed roles, so a reopening can appear as a new addition. New mode keeps free operational summaries/diagnostics in key-value storage, with no company-summary event; source scans and emitted jobs still cost. Optional AI is saved to AI_BRIEF and charged only after persistence. Notification behavior and baseline storage are unchanged.",
            "default": "all"
          },
          "includeDescriptions": {
            "title": "Include descriptions",
            "type": "boolean",
            "description": "Include cleaned job description text when available. Turn off for smaller datasets.",
            "default": true
          },
          "titleKeywords": {
            "title": "Include title keywords",
            "type": "array",
            "description": "Include jobs matching any case-insensitive title substring. Empty means all titles. Matching occurs after source comparison so filters cannot create false closures.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "excludeTitleKeywords": {
            "title": "Exclude title keywords",
            "type": "array",
            "description": "Exclude jobs matching any case-insensitive title substring. Exclusions take precedence over include keywords.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Match any case-insensitive substring in the posting location or country. Combine with title and remote filters; empty means all locations.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Return only jobs explicitly classified as remote. Hybrid, onsite, and unknown arrangements do not match.",
            "default": false
          },
          "watchMode": {
            "title": "Watch mode",
            "type": "boolean",
            "description": "Compare current jobs with your named watchlist state or a selected prior dataset. A first complete watchlist run creates a baseline; later runs advance complete targets automatically. Partial or capped sources cannot prove closures.",
            "default": false
          },
          "watchlistId": {
            "title": "Watchlist ID",
            "type": "string",
            "description": "Stable name for automatic baseline state in your account, used with watchMode. Reuse it for the same monitoring workflow; choose a different name for a different target list."
          },
          "resetBaseline": {
            "title": "Reset watchlist baseline",
            "type": "boolean",
            "description": "Start a fresh native watchlist baseline for this run. Use only when intentionally restarting the comparison, then return this setting to false for scheduled runs.",
            "default": false
          },
          "previousJobsDatasetId": {
            "title": "Previous jobs dataset",
            "type": "string",
            "description": "Optional complete prior-run dataset from this Actor for explicit baseline comparison. Newness depends on history retained in this dataset. Rotating exports can omit older closed roles, allowing a later reopening to be classified and charged as new. Use a stable watchlistId to retain closed-job history across runs; the public new-only task uses native state. Read-only access is granted to the selected dataset."
          },
          "alertWebhookUrl": {
            "title": "Alert webhook URL",
            "type": "string",
            "description": "Optional final HTTP(S) receiver you control. Choose generic JSON, Slack incoming webhook, or Discord webhook below. The URL is secret; redirects are refused. Leave empty to keep results in Apify only."
          },
          "notificationFormat": {
            "title": "Notification format",
            "enum": [
              "generic",
              "slack",
              "discord"
            ],
            "type": "string",
            "description": "Payload expected by your receiver. Generic sends structured JSON; Slack and Discord create native webhook messages.",
            "default": "generic"
          },
          "notifyOnlyChanges": {
            "title": "Notify only changes",
            "type": "boolean",
            "description": "In watch mode, alert only for filtered proven job changes. The first baseline and unchanged comparisons stay quiet. False permits complete snapshot/unchanged summaries; incomplete comparisons stay quiet. Non-watch runs retain snapshot notifications.",
            "default": true
          },
          "replayNotificationStoreId": {
            "title": "Replay notification from run store",
            "type": "string",
            "description": "Optional key-value store of a prior run of this Actor. Read and resend its saved notification without scraping jobs again. Provide the receiver URL separately; replay can duplicate delivery after an ambiguous timeout."
          },
          "enableAiAnalysis": {
            "title": "Enable AI hiring brief",
            "type": "boolean",
            "description": "Generate an optional AI brief over the hiring summaries and changed jobs. Requires the selected provider key or Ollama URL.",
            "default": false
          },
          "llmProvider": {
            "title": "LLM provider",
            "enum": [
              "openrouter",
              "anthropic",
              "google",
              "openai",
              "ollama"
            ],
            "type": "string",
            "description": "Provider for optional AI hiring briefs.",
            "default": "openrouter"
          },
          "llmModel": {
            "title": "LLM model override",
            "type": "string",
            "description": "Optional model override. Leave empty to use the actor default for the selected provider."
          },
          "openrouterApiKey": {
            "title": "OpenRouter API key",
            "type": "string",
            "description": "Get one at https://openrouter.ai/keys. Or set OPENROUTER_API_KEY env var."
          },
          "anthropicApiKey": {
            "title": "Anthropic API key",
            "type": "string",
            "description": "Get one at https://console.anthropic.com/settings/keys. Or set ANTHROPIC_API_KEY env var."
          },
          "googleApiKey": {
            "title": "Google AI API key",
            "type": "string",
            "description": "Get one at https://aistudio.google.com/app/apikey. Or set GOOGLE_API_KEY env var."
          },
          "openaiApiKey": {
            "title": "OpenAI API key",
            "type": "string",
            "description": "Get one at https://platform.openai.com/api-keys. Or set OPENAI_API_KEY env var."
          },
          "ollamaBaseUrl": {
            "title": "Ollama base URL",
            "type": "string",
            "description": "URL of a self-hosted Ollama instance. Default: http://localhost:11434. Install at https://ollama.com/download."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional proxy settings. The documented public ATS feeds normally work without Apify Proxy; enable only when your run environment needs outbound routing.",
            "default": {
              "useApifyProxy": false
            }
          },
          "urls": {
            "title": "ATS board URLs (CLI alias)",
            "type": "string",
            "description": "Hidden alias for atsBoardUrls."
          },
          "domains": {
            "title": "Company domains (CLI alias)",
            "type": "string",
            "description": "Hidden alias for companyDomains."
          },
          "companies": {
            "title": "Company names (CLI alias)",
            "type": "string",
            "description": "Hidden alias for companyNames."
          },
          "maxItems": {
            "title": "Max items (CLI alias)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hidden alias for maxJobsPerCompany."
          },
          "query": {
            "title": "Single query (CLI alias)",
            "type": "string",
            "description": "Hidden alias for a single company, domain, ATS URL, or source:slug input."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}