{
  "openapi": "3.0.1",
  "info": {
    "title": "ATS Job Feeds: Greenhouse, Lever, Ashby, Workable & more",
    "description": "Jobs from public endpoints of Greenhouse, Lever, Ashby, Personio, Workable and Recruitee (until 2027-02-10). Not Workday, SmartRecruiters, Teamtailor. Monitor mode: new, changed, closed jobs, days open, hiring velocity. Recruiter names, e-mails, phones removed.",
    "version": "0.1",
    "x-build-id": "bon06ib82WGjcNigt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datafeed~ats-job-feeds/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datafeed-ats-job-feeds",
        "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/datafeed~ats-job-feeds/runs": {
      "post": {
        "operationId": "runs-sync-datafeed-ats-job-feeds",
        "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/datafeed~ats-job-feeds/run-sync": {
      "post": {
        "operationId": "run-sync-datafeed-ats-job-feeds",
        "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": [
          "companies"
        ],
        "properties": {
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "One per line: a board token with its ATS (`greenhouse:gitlab`, `lever:palantir`, `lever-eu:acme`, `ashby:ashby`, `personio:acme`, `workable:acme`, `recruitee:acme`), a board URL (boards.greenhouse.io/x, jobs.lever.co/x, jobs.ashbyhq.com/x, x.jobs.personio.de, apply.workable.com/x, x.recruitee.com), or a company domain (`acme.com`): the board is then found from links on the company's own site (home page and up to 2 careers pages on the same domain), else by one request per ATS per name guess. Max 200.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "monitor",
              "snapshot",
              "discover"
            ],
            "type": "string",
            "description": "Monitor keeps a per-company history in a named key-value store and returns only what changed (the first check of a company stores a baseline and returns one free `baseline_summary` row, not the jobs, unless 'Return all jobs on the first run' is on).",
            "default": "monitor"
          },
          "keywords": {
            "title": "Keywords (any)",
            "type": "array",
            "description": "Keep jobs whose title (or title + description, see below) contains any of these words. Case-insensitive.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop jobs containing any of these words.",
            "items": {
              "type": "string"
            }
          },
          "keywordsIn": {
            "title": "Match keywords in",
            "enum": [
              "title",
              "title-description"
            ],
            "type": "string",
            "description": "Where keywords are matched.",
            "default": "title"
          },
          "locations": {
            "title": "Locations (any)",
            "type": "array",
            "description": "Keep jobs where any location contains one of these, e.g. `Berlin`, `Germany`, `Remote`.",
            "items": {
              "type": "string"
            }
          },
          "departments": {
            "title": "Departments (any)",
            "type": "array",
            "description": "Keep jobs whose department or team contains one of these.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Only jobs the board marks as remote (or whose location says remote). Hybrid is not remote.",
            "default": false
          },
          "postedSinceDays": {
            "title": "Posted in the last N days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "0 = no date filter. Jobs without a posting date are dropped when this is set.",
            "default": 0
          },
          "maxDescriptionChars": {
            "title": "Description length cap",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Markdown characters per description; 0 = no description.",
            "default": 4000
          },
          "maxJobsPerCompany": {
            "title": "Max rows per company per run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Caps the rows (and charges) per company per run. Monitor mode: the rest are delivered on the next run.",
            "default": 2000
          },
          "emitBaseline": {
            "title": "Return all jobs on the first run",
            "type": "boolean",
            "description": "Monitor mode: off (default) = a company's first check only stores the baseline, returns one free `baseline_summary` row (counts, a sample and the next step) and costs one 'company-checked-unchanged' event (about $0.001); later runs return only new, changed and closed jobs. On = every open job is returned as `new` (with `baseline: true`) on the first check and charged as `job-returned`: e.g. 100 companies x 150 open jobs = 15,000 rows, about $45 at $0.003.",
            "default": false
          },
          "includeChanged": {
            "title": "Return changed jobs",
            "type": "boolean",
            "description": "Title, location, salary or remote flag changed.",
            "default": true
          },
          "includeClosed": {
            "title": "Return closed jobs",
            "type": "boolean",
            "description": "Jobs that disappeared from the board, with `closedAt` and `daysOpen` (time to fill).",
            "default": true
          },
          "closeAfterMissedChecks": {
            "title": "Missed checks before a job counts as closed",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Consecutive checks a job must be missing before it counts as closed (default 2, so a one-off glitch never closes a job). The closing date is always the first missed check. Boards that empty, drop by 30 %+ (and 5+ jobs) or are multi-page Lever boards always need at least 2.",
            "default": 2
          },
          "emitCompanyStats": {
            "title": "Add one stats row per company",
            "type": "boolean",
            "description": "Free row with open jobs, new/closed in 30 and 90 days, net change and median days open of closed jobs. Always in the SUMMARY record too.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store holding the history. Use one schedule per store name.",
            "default": "ats-job-feeds"
          },
          "personioLanguage": {
            "title": "Personio feed language",
            "enum": [
              "en",
              "de",
              "fr",
              "es",
              "nl",
              "it",
              "pt",
              "sv",
              "da",
              "fi",
              "pl",
              "cs"
            ],
            "type": "string",
            "description": "Language requested from Personio feeds.",
            "default": "en"
          },
          "perHostDelayMs": {
            "title": "Delay between requests to one host (ms)",
            "minimum": 1000,
            "maximum": 30000,
            "type": "integer",
            "description": "Politeness delay; robots.txt Crawl-delay is honoured when larger.",
            "default": 1500
          },
          "timeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 5,
            "maximum": 60,
            "type": "integer",
            "description": "Per request.",
            "default": 30
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}