{
  "openapi": "3.0.1",
  "info": {
    "title": "ATS Jobs Scraper: Greenhouse, Lever, Ashby, Workday & More",
    "description": "Job postings API for company career pages: live jobs from Greenhouse, Lever, Ashby, Workday, iCIMS and 14 more ATS, with salary when posted. Pay per job.",
    "version": "1.1",
    "x-build-id": "ZyFNfapxgTlHfClnj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cleanyield~ats-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cleanyield-ats-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/cleanyield~ats-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-cleanyield-ats-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/cleanyield~ats-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-cleanyield-ats-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": "Companies",
            "type": "array",
            "description": "One company per line. Accepted: a company name (Stripe, Scale AI), the company website (figma.com — the Actor follows its Careers link to the job board), a job board URL (https://job-boards.greenhouse.io/anthropic, https://jobs.lever.co/spotify, https://jobs.eu.lever.co/<company>, https://jobs.ashbyhq.com/ramp, https://bunq.recruitee.com, https://<company>.jobs.personio.de, https://<company>.teamtailor.com, https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite, https://<tenant>.fa.<dc>.oraclecloud.com/hcmUI/CandidateExperience/en/sites/<site>, https://<company>.eightfold.ai/careers, a Phenom careers portal such as https://talent.lowes.com/us/en/search-results), the company's own careers page (https://www.figma.com/careers), or a prefixed token (greenhouse:stripe, lever:palantir, lever-eu:<company>, ashby:openai, recruitee:bunq, personio:<company>, teamtailor:<company>). For a bare name the Actor tries Greenhouse and Ashby first, then Lever, then Recruitee, Personio and Teamtailor. Workday, Oracle Recruiting Cloud, Eightfold and Phenom sites need their URL or the company website (emerson.com, bostonscientific.com, lowes.com). Example: [\"anthropic\", \"https://jobs.lever.co/spotify\", \"ashby:ramp\"]. Can be left empty when you use a saved list (see \"Saved list name\").",
            "items": {
              "type": "string"
            }
          },
          "savedListName": {
            "title": "Saved list name (optional)",
            "type": "string",
            "description": "Give your company list a name (e.g. \"my-target-accounts\") and the Actor remembers it: next runs and schedules use the saved companies plus any you add here. Stored in your own Apify account (key-value store \"saved-lists\"). Leave empty to use only the companies above."
          },
          "saveList": {
            "title": "Save new companies into the saved list",
            "type": "boolean",
            "description": "With a saved list name: add the companies of this run to the saved list. Turn off to use the saved list without changing it.",
            "default": true
          },
          "maxJobsPerCompany": {
            "title": "Max jobs per company",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum jobs returned per company after filters, newest first. 0 = all open jobs. Use it to cap cost on big employers (some have 800+ open jobs). Example: 50.",
            "default": 0
          },
          "maxResults": {
            "title": "Max results per run",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Stop after this many jobs in total across all companies. 0 = no limit. You pay only for jobs actually returned. Example: 1000.",
            "default": 0
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Keep only jobs whose title contains at least one of these words or phrases (case-insensitive; 'engineer' also matches 'Engineering'; words of 3 letters or less like 'AI' or 'QA' match whole words only). Leave empty for all jobs. Example: [\"engineer\", \"data scientist\"].",
            "items": {
              "type": "string"
            }
          },
          "keywordScope": {
            "title": "Search keywords in",
            "enum": [
              "title",
              "titleAndDescription"
            ],
            "type": "string",
            "description": "Where to look for the keywords: only the job title (precise, default) or the title and the full description (broader, e.g. to find every job that mentions 'Kubernetes').",
            "default": "title"
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop jobs whose title contains any of these words. Example: [\"intern\", \"senior director\"].",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Keep jobs in any of these places: a city (London), a US state or region code (CA), a country name or ISO code (Germany, DE, United States) or the word 'remote'. Matches the main location and every additional location of the job. Example: [\"United States\", \"London\", \"remote\"].",
            "items": {
              "type": "string"
            }
          },
          "excludeLocations": {
            "title": "Exclude locations",
            "type": "array",
            "description": "City, state code, country name or ISO code, or \"remote\". A job is dropped only when ALL its locations match (a job in \"London | Remote US\" stays if you exclude UK). Example: [\"India\"].",
            "items": {
              "type": "string"
            }
          },
          "workplaceTypes": {
            "title": "Workplace type",
            "type": "array",
            "description": "Keep only remote, hybrid and/or on-site jobs. Jobs whose ATS does not say the workplace type (and whose location does not mention it) are excluded when this filter is set. Example: [\"remote\"].",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid",
                "On-site"
              ]
            }
          },
          "departments": {
            "title": "Departments or teams",
            "type": "array",
            "description": "Keep jobs whose department or team contains any of these texts (case-insensitive). Example: [\"engineering\", \"sales\"].",
            "items": {
              "type": "string"
            }
          },
          "employmentTypes": {
            "title": "Employment type",
            "type": "array",
            "description": "Keep only these employment types (normalized across ATS): full_time, part_time, contract, internship, temporary, other. Jobs with unknown type are excluded when this filter is set. Example: [\"full_time\"].",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "contract",
                "internship",
                "temporary",
                "other"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contract",
                "Internship",
                "Temporary",
                "Other"
              ]
            }
          },
          "postedWithinDays": {
            "title": "Posted within the last N days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep only jobs published in the last N days (by the ATS publish date). 0 = any date. Example: 7.",
            "default": 0
          },
          "postedAfter": {
            "title": "Posted on or after (exact date)",
            "type": "string",
            "description": "Keep only jobs published on or after this exact date or time (ISO 8601, e.g. 2026-10-01 or 2026-10-01T09:00:00Z), or a relative time like \"48 hours\" or \"7 days\". Jobs without a publish date are left out. Empty = any date."
          },
          "minSalary": {
            "title": "Minimum annual salary",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only jobs whose published salary range reaches at least this amount per year (hourly and monthly pay are annualized). Compared in the currency below, without conversion. Jobs without a published salary are excluded unless you tick the next option. 0 = no salary filter. Example: 150000.",
            "default": 0
          },
          "salaryCurrency": {
            "title": "Salary currency",
            "type": "string",
            "description": "ISO 4217 currency of the minimum salary (USD, EUR, GBP, CAD…). Only jobs paid in this currency pass the salary filter. Example: USD.",
            "default": "USD"
          },
          "includeJobsWithoutSalary": {
            "title": "Keep jobs without a published salary",
            "type": "boolean",
            "description": "With a minimum salary set: also keep jobs that do not publish a salary.",
            "default": false
          },
          "onlyWithSalary": {
            "title": "Only jobs with a published salary",
            "type": "boolean",
            "description": "Keep only jobs that publish a salary (structured from the ATS or an explicit range in the job text).",
            "default": false
          },
          "seniorities": {
            "title": "Seniority",
            "type": "array",
            "description": "Keep only these levels, read from the job title: intern, entry (junior, new grad, I), mid (II, intermediate), senior (senior, III), lead (staff, principal, lead), director (director, head of), executive (VP, chief). Titles without a level are excluded when this filter is set. Example: [\"intern\", \"entry\"] for students and freshers.",
            "items": {
              "type": "string",
              "enum": [
                "intern",
                "entry",
                "mid",
                "senior",
                "lead",
                "director",
                "executive"
              ],
              "enumTitles": [
                "Intern",
                "Entry / junior",
                "Mid",
                "Senior",
                "Lead / staff / principal",
                "Director / head of",
                "Executive (VP, C-level)"
              ]
            }
          },
          "maxExperienceYears": {
            "title": "Max years of experience required",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Drop jobs that ask for MORE than N years of experience (read from phrases like \"5+ years of experience\"). Jobs that do not say are kept. Example: 2 for freshers and early-career."
          },
          "onlyVisaSponsorship": {
            "title": "Only jobs that say they sponsor visas",
            "type": "boolean",
            "description": "Keep only jobs whose text explicitly says visa sponsorship is offered (\"we sponsor visas\", \"visa sponsorship is available\").",
            "default": false
          },
          "includeDescription": {
            "title": "Job description",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "Include the full job description as clean plain text (default, best for AI and spreadsheets), as the original HTML, both, or none (smaller output).",
            "default": "text"
          },
          "outputFormat": {
            "title": "Output field names",
            "enum": [
              "standard",
              "leader-compatible"
            ],
            "type": "string",
            "description": "standard = this Actor's fields (recommended). leader-compatible = the field names used by the most popular career-site job APIs on the Store (title, organization, date_posted, locations_alt, countries_derived, ai_salary_min_value, ai_work_arrangement, description_text…) so you can switch without changing your integration. Values still come from the ATS, not from AI.",
            "default": "standard"
          },
          "includeAtsFields": {
            "title": "Add ATS-specific fields",
            "type": "boolean",
            "description": "Also return the fields only each ATS publishes (no extra cost): Greenhouse requisition ID, department path, offices, every pay range and custom fields; Lever commitment, level and the posting's requirement lists as bullets; Ashby compensation tiers with equity, commission and bonus, and secondary locations; Workday requisition ID, exact posting date, time type and hiring entity. Off = the standard fields only (same output as before).",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new or changed jobs)",
            "type": "boolean",
            "description": "For scheduled runs: remember the jobs found last time (per company) and output only jobs that are new or changed (title, location, salary, workplace type…) since the previous run. Each item has changeType new or changed (and changedFields). You pay only for new/changed jobs plus a small fee per company checked. Schedule the Actor daily or weekly from the Schedules tab.",
            "default": false
          },
          "monitorStateName": {
            "title": "Monitor state name",
            "type": "string",
            "description": "Optional name of the storage that keeps the previous results. Use the same name across scheduled runs to compare against them. Leave empty to derive it automatically from your filters (so you can add companies to the list without losing history). Lowercase letters, numbers and hyphens only. Example: my-watchlist-daily."
          },
          "includeClosedJobs": {
            "title": "Also report closed jobs",
            "type": "boolean",
            "description": "In monitor mode: also output jobs that disappeared from the board since the last run (changeType closed). Closed jobs count as results. Never reported for a company that could not be read or was cut by 'Max jobs per company'.",
            "default": false
          },
          "skipExistingOnFirstRun": {
            "title": "First run: save baseline only",
            "type": "boolean",
            "description": "In monitor mode: on the first run for a company, store its current jobs as the baseline without outputting or charging them, so you are alerted only about jobs posted from now on.",
            "default": false
          },
          "notifyWebhookUrl": {
            "title": "Webhook URL for alerts",
            "type": "string",
            "description": "Optional. When monitor mode finds new or changed jobs, POST a JSON summary (title, lines, items with jobId, company, title, location, salary, url) to this URL. Works with Zapier, Make and n8n (use it to send emails too). Example: https://hooks.zapier.com/hooks/catch/123/abc"
          },
          "notifySlackWebhookUrl": {
            "title": "Slack webhook URL for alerts",
            "type": "string",
            "description": "Optional. Slack incoming-webhook URL to receive a message when monitor mode finds new or changed jobs (per-company hiring summary + the newest jobs). Example: https://hooks.slack.com/services/T000/B000/XXXX"
          },
          "proMode": {
            "title": "Pro mode",
            "type": "boolean",
            "description": "Turns on every extra for each job: company hiring score (0–100), \"hiring is accelerating\" flag, jobs posted by the company in the last 30 days, hiring trend since you started running it (stored in your account), a \"why now\" line for sales outreach, technologies mentioned in the job, and a one-sentence AI insight written only from the job's data. Charged as \"pro-result\" per job on top of the base price.",
            "default": false
          },
          "enrichCompanies": {
            "title": "Add company details (emails, phones, socials, tech)",
            "type": "boolean",
            "description": "Reads each hiring company's own website once per run and adds companyDetails to its jobs: primary email and phone, LinkedIn and X profiles, country and website technologies. Charged once per company with useful data (\"company-enriched\"); companies without a website or without data are free.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: these ATS publish their job board feeds openly, so the Actor connects directly (cheaper and faster). Only enable a proxy if your network requires one. Example: {\"useApifyProxy\": false}.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}