{
  "openapi": "3.0.1",
  "info": {
    "title": "Career Site Job Search API: Workday, Greenhouse, Lever & More",
    "description": "Search open jobs by title across 17,000+ company career sites on Workday, Greenhouse, Lever, Ashby, SmartRecruiters, Workable, BambooHR, Personio, Teamtailor, Rippling and Recruitee. Live data read at run time, with location, remote, date and salary filters, full descriptions and new-job monitoring.",
    "version": "0.1",
    "x-build-id": "IfOAMfj96cG1GBOjK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/makerio~career-site-job-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-makerio-career-site-job-search",
        "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/makerio~career-site-job-search/runs": {
      "post": {
        "operationId": "runs-sync-makerio-career-site-job-search",
        "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/makerio~career-site-job-search/run-sync": {
      "post": {
        "operationId": "run-sync-makerio-career-site-job-search",
        "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": [
          "searchText"
        ],
        "properties": {
          "searchText": {
            "title": "Job title or keyword",
            "type": "string",
            "description": "Required. One job title or keyword that must appear in the job title, for example \"data engineer\", \"registered nurse\" or \"product designer\". Not case sensitive; whole words with common endings (\"engineer\" also finds \"Engineering\"). The description is not searched here (use descriptionKeywords). To search several titles, start one run per title."
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Optional. Keep jobs in any of these places, checked against every location of the job. Use a city, region or country name (\"Berlin\", \"California\", \"United States\"), a two-letter country code (\"US\") or \"Remote\". Leave empty for jobs worldwide. Jobs whose location is only a site name without a city or country (for example \"Katy Hospital\") are left out when this is set.",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Keep only jobs the company marks as remote, or with \"remote\" in the location.",
            "default": false
          },
          "postedWithinDays": {
            "title": "Posted within the last N days",
            "minimum": 1,
            "type": "integer",
            "description": "Optional. Keep only jobs published in the last N days, for example 1 for today and yesterday or 7 for the past week. Leave empty for any age; results are always sorted newest first."
          },
          "maxJobs": {
            "title": "Max jobs in total",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many jobs (default 50; the example uses 10). Each returned job costs $0.005, so this also caps the cost of the run: 50 jobs cost $0.03 + $0.25.",
            "default": 50
          },
          "maxJobsPerCompany": {
            "title": "Max jobs per company",
            "minimum": 1,
            "type": "integer",
            "description": "Return at most this many jobs from one company, so a few big employers do not fill the whole result.",
            "default": 5
          },
          "ats": {
            "title": "Career site platforms",
            "type": "array",
            "description": "Search only these platforms. Leave empty to search all of them.",
            "items": {
              "type": "string",
              "enum": [
                "workday",
                "greenhouse",
                "lever",
                "ashby",
                "smartrecruiters",
                "workable",
                "recruitee",
                "personio",
                "bamboohr",
                "teamtailor",
                "rippling"
              ],
              "enumTitles": [
                "Workday",
                "Greenhouse",
                "Lever",
                "Ashby",
                "SmartRecruiters",
                "Workable",
                "Recruitee",
                "Personio",
                "BambooHR",
                "Teamtailor",
                "Rippling"
              ]
            }
          },
          "companies": {
            "title": "Only these companies",
            "type": "array",
            "description": "Optional. Search only these companies instead of every known career site: company names, careers page URLs or job board URLs from any of the supported platforms, including SAP SuccessFactors career sites on a company's own domain such as careers.ey.com.",
            "items": {
              "type": "string"
            }
          },
          "excludeTitleKeywords": {
            "title": "Job title does not contain",
            "type": "array",
            "description": "Drop jobs whose title contains any of these words or phrases, for example \"intern\" or \"director\".",
            "items": {
              "type": "string"
            }
          },
          "descriptionKeywords": {
            "title": "Description contains any of",
            "type": "array",
            "description": "Keep jobs that mention at least one of these terms in the title or the full description, for example \"Kubernetes\" or \"SAP\".",
            "items": {
              "type": "string"
            }
          },
          "employmentTypes": {
            "title": "Employment types",
            "type": "array",
            "description": "Keep only these employment types.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "contract",
                "temporary",
                "internship"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contract",
                "Temporary",
                "Internship"
              ]
            }
          },
          "requireSalary": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Keep only jobs that state a pay range, in the job data or in the description.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Job description format",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "How to return the full job description. Choose \"No description\" for the fastest run.",
            "default": "text"
          },
          "onlyNewJobs": {
            "title": "Only jobs not returned before",
            "type": "boolean",
            "description": "Remember returned jobs between runs and output only postings that are new since the last run. Ideal for a daily schedule that feeds job alerts.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional. Runs with the same monitor name share their memory of returned jobs. Use different names to track different searches separately."
          },
          "maxSearchSeconds": {
            "title": "Search time limit (seconds)",
            "minimum": 30,
            "type": "integer",
            "description": "Stop reading new career sites after this many seconds and return what was found. Sites are read biggest first, so the limit leaves out only the smallest ones; the run summary says how many. The example uses 30 seconds (about a minute per run); the default of 90 seconds finds about 90% of the matches in about 2 minutes. Set 300 to read every site.",
            "default": 90
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}