{
  "openapi": "3.0.1",
  "info": {
    "title": "Greenhouse Jobs Scraper: Live Boards, Pay, New-Job Alerts",
    "description": "Greenhouse jobs live from each company's own board, $1.00 per 1,000 jobs: pay range and pay written in the description, seniority, an only-new watch with Slack or webhook alerts. Input: Greenhouse board links or names. $0.70 per 1,000 jobs on Business.",
    "version": "0.1",
    "x-build-id": "JWNJbF7cboA0EXwZK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fetchwright~greenhouse-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fetchwright-greenhouse-jobs-scraper",
        "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/fetchwright~greenhouse-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fetchwright-greenhouse-jobs-scraper",
        "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/fetchwright~greenhouse-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fetchwright-greenhouse-jobs-scraper",
        "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": {
          "companies": {
            "title": "Greenhouse boards (links or names)",
            "type": "array",
            "description": "The companies whose open Greenhouse jobs you want, one per line: the board link, such as **https://job-boards.greenhouse.io/airbnb** (boards.greenhouse.io and embed links work too), or the board name, such as **stripe** or **greenhouse:stripe**. A name written with spaces or capitals, such as Scale AI, is read as the board name scaleai. A board of another system (Lever, Ashby, Workday and others) stops the run before any request, with nothing charged: read those with Company Career Page Jobs Scraper. A company without a Greenhouse board costs nothing. Leave it empty to find boards by keyword only (below).",
            "items": {
              "type": "string"
            }
          },
          "maxJobs": {
            "title": "Maximum jobs per run",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "A hard cap: the run never saves more than this many jobs, for example **100**. You pay per job saved ($1.00 per 1,000 on the Free plan), so this caps the cost of a run. Companies are read in the order you list them, newest jobs first. Default: 100.",
            "default": 100
          },
          "maxJobsPerCompany": {
            "title": "Maximum jobs per company",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Optional, for example **30**: at most this many jobs per board, newest first. Default empty: no per-company limit. Jobs left out by it are not charged."
          },
          "searchKeywords": {
            "title": "Find boards by keyword",
            "type": "array",
            "description": "Optional. Find Greenhouse boards of companies you do not name: for each keyword, one per line, for example **data engineer** or **product designer**, a web search finds Greenhouse boards that list such jobs, and those boards are read. Only their jobs that match the keyword are saved (each row says which in foundByKeyword); finding boards costs nothing. Results are the boards the search engine has indexed for the keyword, so boards can be missed; at most 10 boards are read per keyword. Paid Apify plans only: each keyword is a web search, so on the Free plan a run with keywords stops before any request, with nothing charged. At most 5 keywords per run.",
            "items": {
              "type": "string"
            }
          },
          "searchLocation": {
            "title": "Location for the keyword search",
            "type": "string",
            "description": "Optional. A place such as **London** or **Germany**: from boards found by keyword, only jobs that state this place are saved. Boards you list above are not affected (use Locations below for them)."
          },
          "keywords": {
            "title": "Title keywords",
            "type": "array",
            "description": "Optional. Keep only jobs whose title contains any of these, one per line, for example **engineer** or **data analyst**. Every word of a line must appear in the title, in any order, at the start of a word, ignoring case. Jobs left out are not saved and not charged. Each saved row lists the keywords it matched (matchedKeywords).",
            "items": {
              "type": "string"
            }
          },
          "keywordScope": {
            "title": "Match keywords in",
            "enum": [
              "title",
              "title_and_description"
            ],
            "type": "string",
            "description": "Where the title keywords above are looked for. **Job title and description** also keeps a job whose description contains a keyword line as written (its words next to each other, in that order, at the start of a word, ignoring case), whether or not you include descriptions in the rows. Exclude keywords always look at the title only. Default: Job title only.",
            "default": "title"
          },
          "excludeKeywords": {
            "title": "Exclude title keywords",
            "type": "array",
            "description": "Optional. Leave out jobs whose title contains any of these, one per line, for example **senior** or **internship**. Every word of a line must appear in the title as a whole word: **intern** leaves out Software Intern, not Internal Tools Engineer. Jobs left out are not charged.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Optional. Keep only jobs in any of these places, one per line, for example **Berlin**, **San Francisco, CA** or **Remote**. A line is one phrase (a comma does not split it); its words must appear as whole words in a location the employer states, ignoring case. A two-letter code such as **US** also matches the country Lever states. Jobs left out are not charged.",
            "items": {
              "type": "string"
            }
          },
          "departments": {
            "title": "Departments or teams",
            "type": "array",
            "description": "Optional. Keep only jobs whose department or team contains any of these, one per line, for example **Engineering** or **Sales**. Ignoring case. Jobs left out are not charged.",
            "items": {
              "type": "string"
            }
          },
          "seniorities": {
            "title": "Seniority",
            "type": "array",
            "description": "Optional. Keep only jobs whose title states one of these levels, for example **Senior** and **Lead**. The level is read from the job title by fixed rules (each row has it in seniority); a job whose title states no level, such as Software Engineer, is left out and counted as no_seniority unless you keep it below. Jobs left out are not charged.",
            "items": {
              "type": "string",
              "enum": [
                "intern",
                "junior",
                "mid",
                "senior",
                "lead",
                "principal",
                "director",
                "manager"
              ],
              "enumTitles": [
                "Intern",
                "Junior",
                "Mid",
                "Senior",
                "Lead",
                "Principal (Staff, Principal, Distinguished)",
                "Director (Head of, Director, VP, Chief)",
                "Manager"
              ]
            }
          },
          "keepUnknownSeniority": {
            "title": "Keep jobs whose title states no level",
            "type": "boolean",
            "description": "With a seniority filter, also keep jobs whose title states no level (seniority null), for example Software Engineer or Data Scientist. Off by default.",
            "default": false
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Keep only jobs marked remote (isRemote true): a workplace type of remote where the board states one in its custom fields, or, where it states none (most Greenhouse boards), a location that says Remote, for example **Remote - US**. Jobs left out are not charged. Default: off.",
            "default": false
          },
          "workplaceTypes": {
            "title": "Workplace",
            "type": "array",
            "description": "Optional. Keep only jobs whose workplace is one of these, for example **Hybrid** and **On-site**. The workplace is the board's own workplace field where it has one (workplaceType); a job with none stated counts as Remote when its location says Remote. Most Greenhouse boards state no workplace type: such jobs are left out and counted as no_workplace in the run summary, unless you keep them below. Jobs left out are not charged.",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid",
                "On-site"
              ]
            }
          },
          "keepUnstatedWorkplace": {
            "title": "Keep jobs whose workplace is not stated",
            "type": "boolean",
            "description": "With a workplace filter set, also keeps jobs whose board states no workplace type and does not mark them remote, for example **most Greenhouse jobs**. Off by default: such jobs are left out and counted as no_workplace. Jobs that state another workplace are still left out.",
            "default": false
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Optional. Keep only jobs whose employment type, as the board states it, is one of these, one per line, for example **Full-time**, **Part-time**, **Contract** or **Intern**. Case, spaces and punctuation are ignored, and these are read as one type: Full-time and Full Time Employee; Part-time and Part Time Employee; Intern and Internship; Contract and Contractor; Temporary and Temp. Any other type matches only itself (Intern does not match Internal Only; Permanent is not Full-time). Most Greenhouse boards state no employment type, so their jobs are left out while this is set. Jobs left out are not charged.",
            "items": {
              "type": "string"
            }
          },
          "minSalary": {
            "title": "Minimum salary",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Keep only jobs whose published pay range reaches at least this amount, for example **120000**. Compared in the job's own currency and interval (a year, an hour), with no conversion; add Salary currency to keep one currency. Jobs without a published pay range are left out while a salary filter is set, and are not charged."
          },
          "maxSalary": {
            "title": "Maximum salary",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Keep only jobs whose published pay range starts at or below this amount, for example **90000**. Compared in the job's own currency and interval, with no conversion. Jobs without a published pay range are left out while a salary filter is set, and are not charged."
          },
          "salaryCurrency": {
            "title": "Salary currency",
            "type": "string",
            "description": "Optional. Keep only jobs whose published pay range is in this currency, a three-letter code such as **USD**, **EUR** or **GBP**. Jobs without a published pay range are left out while it is set, and are not charged."
          },
          "postedWithinDays": {
            "title": "Posted in the last days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional, for scheduled runs: only jobs first published on or after the date this many days before the run, for example **7**. Jobs whose board states no posting date are left out while this is set. When a start date is also set, the later of the two applies."
          },
          "postedSince": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Optional date the job was first published, for example **2026-11-01**. Jobs whose board states no posting date are left out while this is set. Leave empty for no lower bound."
          },
          "updatedSince": {
            "title": "Updated on or after",
            "type": "string",
            "description": "Optional date of the job's last update on Greenhouse, for example **2026-11-01**. Jobs with no update date and no posting date are left out while this is set. Leave empty for no lower bound."
          },
          "includeDescription": {
            "title": "Include the job description",
            "type": "boolean",
            "description": "Adds the full job description as the employer published it, as plain text, HTML or Markdown (see Description format), for example **the responsibilities and requirements**. Off by default, for smaller rows. No extra request and no extra charge: pay written in the description (payFromText) is read with descriptions off too.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "How the description is written when descriptions are included: **Plain text** (as before), **HTML** (the employer's formatting, with scripts, styles, images and every attribute except link addresses removed) or **Markdown** (headings, bold, lists and links). The same response is read in every format: no extra request and no extra charge. Has no effect while descriptions are off. Default: Plain text.",
            "default": "text"
          },
          "onlyNew": {
            "title": "Only new jobs (watch)",
            "type": "boolean",
            "description": "For scheduled monitoring, for example a daily run on your target companies. The first run returns up to your maximum of the newest matching jobs and remembers every job open on each board it reads, also boards read after your maximum is reached (nothing saved or charged for them); with one run of the watch at a time, each later run returns only jobs that appeared after. Older matches are not back-filled. A job the watch returned that has gone from a board read to its end is listed once, free, in the run's CLOSED_JOBS record, not as a row. A board the watch has not read yet gets its first read, up to your maximum, in the run that first reads it. Run a watch one at a time: two runs started in the same seconds can both return and charge the same job. Default: off.",
            "default": false
          },
          "watchName": {
            "title": "Watch name",
            "type": "string",
            "description": "Optional. Give a watch its own memory, for example **ai-labs-engineering**. A named watch keeps its memory when you change its companies or filters (a company you add gets a first run of its own). For a schedule, turn on Apify's setting not to start a new run while the previous one is running. Without a name, each saved task keeps one memory per set of companies and filters, and API runs share one per set. The memory belongs to this Actor: a watch of the same name in our other job Actors keeps its own."
          },
          "notifyWebhookUrl": {
            "title": "Send an alert to Slack, Discord or a webhook",
            "type": "string",
            "description": "Optional. Paste a Slack or Discord incoming-webhook address, or any https:// address that accepts JSON, for example **https://hooks.slack.com/services/...**. When the run saves jobs, a short message is posted there: the count, the first three titles with company, location and link, and a link to all rows. No extra charge."
          },
          "notifyWhenNothingFound": {
            "title": "Alert even when nothing was saved",
            "type": "boolean",
            "description": "Also post the alert when the run saved no jobs, for example to confirm that a scheduled check ran. Off by default, so a quiet run sends nothing.",
            "default": false
          },
          "companiesFromDataset": {
            "title": "Companies from a dataset",
            "type": "string",
            "description": "Optional. The ID of a dataset in your account, for example **the output of another Actor** that lists companies, such as aBcD1234eFgH5678. The Greenhouse board links it recognizes in its rows (up to 5,000 rows) are added to the companies above; values of other job-board systems are left out."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}