{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Jobs Scraper: Work at a Startup & YC Jobs",
    "description": "YC jobs scraper for Work at a Startup, Y Combinator's startup job board: every open job of every YC company, newest first, by keyword, company or link. Description, salary and equity parsed, role, posting age, remote, visa, batch and founders. Place, role, date filters. No login. Misses free.",
    "version": "0.1",
    "x-build-id": "mFM8sN2EvwD8vlOtJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hyperbach~workatastartup-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hyperbach-workatastartup-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/hyperbach~workatastartup-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-hyperbach-workatastartup-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/hyperbach~workatastartup-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-hyperbach-workatastartup-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": {
          "queries": {
            "title": "Search queries",
            "maxItems": 100,
            "type": "array",
            "description": "Keyword searches over every open job of YC's Work at a Startup board, newest first. A job matches when its title holds every word of the query, as whole words, any case (`searchIn` adds the description). Each query is its own search with its own summary row. `*` reads every open job. A workatastartup.com or ycombinator.com job-list link works here too (its role and place become the search's filters).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "YC companies",
            "maxItems": 1000,
            "type": "array",
            "description": "Every open job of these companies: a slug (`artifact-2`), a workatastartup.com or ycombinator.com company link, or the company's name (the YC directory finds its slug). Read as given: the search filters do not apply, `maxItemsPerCompany` does.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "jobUrls": {
            "title": "Job links or ids",
            "maxItems": 5000,
            "type": "array",
            "description": "Single jobs: a job id (`76154`), a workatastartup.com job link, or a ycombinator.com job link. A closed or missing job is a free row that says so.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchIn": {
            "title": "Match the query in",
            "enum": [
              "title",
              "titleAndDescription"
            ],
            "type": "string",
            "description": "Where a query's words must be: the title (the default: the whole list is matched at once), or the title or the description (each job's own page is read, newest first, with a read budget of 100 pages and then 15 a delivered job; the search row says how many jobs matched).",
            "default": "title"
          },
          "locations": {
            "title": "Locations",
            "maxItems": 50,
            "type": "array",
            "description": "City, region, country name or two-letter country code. A country matches the places a job names and the countries its remote part names (`Remote (US; CA)`); EU and Europe expand to their countries; a city or another place matches the job's own location words. Empty: every location.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "locationTypes": {
            "title": "Work arrangement",
            "type": "array",
            "description": "remote (the job's location has a remote part), hybrid (the location or the description says hybrid), onsite (a place, not hybrid). A job matches when it offers any arrangement selected. Empty: every arrangement.",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "hybrid",
                "onsite"
              ],
              "enumTitles": [
                "Remote",
                "Hybrid",
                "On-site"
              ]
            },
            "default": []
          },
          "employmentTypes": {
            "title": "Employment type",
            "type": "array",
            "description": "The board's own types: Full-time, Contract, Internship, Co-founder (the board has no Part-time job; it is accepted for the leader's inputs and matches nothing). Empty: every type.",
            "items": {
              "type": "string",
              "enum": [
                "Full-time",
                "Contract",
                "Internship",
                "Co-founder",
                "Part-time"
              ]
            },
            "default": []
          },
          "roles": {
            "title": "Role",
            "type": "array",
            "description": "The job's role as YC files it (read from the company's ycombinator.com jobs page, one page a company, newest first, with a read budget like searchIn's). Empty: every role.",
            "items": {
              "type": "string",
              "enum": [
                "eng",
                "design",
                "product",
                "science",
                "sales",
                "marketing",
                "support",
                "operations",
                "recruiting",
                "finance",
                "legal"
              ],
              "enumTitles": [
                "Engineering",
                "Design",
                "Product",
                "Science",
                "Sales",
                "Marketing",
                "Support",
                "Operations",
                "Recruiting & HR",
                "Finance",
                "Legal"
              ]
            },
            "default": []
          },
          "postedWithin": {
            "title": "Posted within",
            "pattern": "^(any|[1-9][0-9]{0,4}[hdwmHDWM])$",
            "type": "string",
            "description": "Only jobs posted within this time: `24h`, `7d`, `2w`, `1m` (30 days); `any` reads every age. The age is the source's own words (\"6 days\", \"about 1 month\"), so a window's edge is as exact as those words.",
            "default": "any"
          },
          "minSalary": {
            "title": "Minimum yearly salary",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Jobs whose salary range reaches this yearly figure in `salaryCurrency` (a monthly or hourly range counts as 12 months or 2,080 hours). A job with no salary, another currency or no stated period is kept unless onlyWithSalary is on. 0: no salary filter.",
            "default": 0
          },
          "salaryCurrency": {
            "title": "Salary currency",
            "enum": [
              "USD",
              "EUR",
              "GBP",
              "CAD",
              "INR",
              "AUD",
              "SGD",
              "CHF",
              "JPY",
              "BRL",
              "MXN"
            ],
            "type": "string",
            "description": "The currency of minSalary (no conversion: a job in another currency is not compared).",
            "default": "USD"
          },
          "onlyWithSalary": {
            "title": "Only jobs that show a salary",
            "type": "boolean",
            "description": "Leave out the jobs that show no salary (with minSalary: the jobs whose salary cannot be compared).",
            "default": false
          },
          "visa": {
            "title": "Visa",
            "type": "array",
            "description": "The job's visa terms as the board states them. Empty: every job.",
            "items": {
              "type": "string",
              "enum": [
                "Will sponsor",
                "US citizenship/visa not required",
                "US citizen/visa only"
              ]
            },
            "default": []
          },
          "maxExperienceYears": {
            "title": "Most years of experience asked",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Jobs that ask at most this many years (0 = jobs open to new grads). Jobs that state no experience are left out when this is set. Empty: no filter."
          },
          "batches": {
            "title": "YC batches",
            "maxItems": 100,
            "type": "array",
            "description": "Companies of these YC batches: `W25`, `S24`, `F24`, `X25` or `Winter 2025`. Read at the source: fewer companies are read. Empty: every batch.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "maxItems": 50,
            "type": "array",
            "description": "Companies in these YC directory industries (`B2B`, `Fintech`, `Healthcare`, `Consumer`, `Engineering, Product and Design`, …; any case). An unknown name is named in the run's notes with the directory's list. Empty: every industry.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minTeamSize": {
            "title": "Smallest team size",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Companies with at least this many people (the directory's team size). 0: no floor.",
            "default": 0
          },
          "maxTeamSize": {
            "title": "Largest team size",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Companies with at most this many people. 0: no ceiling.",
            "default": 0
          },
          "topCompaniesOnly": {
            "title": "YC top companies only",
            "type": "boolean",
            "description": "Only the companies the YC directory marks as top companies.",
            "default": false
          },
          "maxItems": {
            "title": "Max jobs (whole run)",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "The most charged jobs of the whole run; 0 = every match (the whole board is about 6,300 jobs).",
            "default": 0
          },
          "maxItemsPerCompany": {
            "title": "Max jobs per company",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "The most jobs of one company in the run (a search and a company input alike); 0 = no cap.",
            "default": 0
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "maxLength": 2000,
            "type": "string",
            "description": "A note to the people who maintain this Actor: what you needed and did not get. For example a missing field, a wrong or empty result, or the Actor you switch from or to, and why. The run does not read it: the rows and the charges stay the same. A person reads every note."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}