{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Companies & Jobs Scraper: YC Startup Directory",
    "description": "Scrape the Y Combinator company directory (~6,000 YC startups) by batch, industry, region, status, tags or team size: one-liner, description, website, team size, launch date and hiring flag. Jobs mode: YC startup jobs with salary and equity. $3 per 1,000 companies or jobs.",
    "version": "0.1",
    "x-build-id": "DJnJiMMmfC0SNfl1o"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cprussin~ycombinator-companies/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cprussin-ycombinator-companies",
        "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/cprussin~ycombinator-companies/runs": {
      "post": {
        "operationId": "runs-sync-cprussin-ycombinator-companies",
        "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/cprussin~ycombinator-companies/run-sync": {
      "post": {
        "operationId": "run-sync-cprussin-ycombinator-companies",
        "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": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "companies",
              "jobs"
            ],
            "type": "string",
            "description": "Companies: the YC company directory (all ~6,000 YC startups), filtered by batch, industry, region, status, tags and more. Jobs: open jobs at YC startups by role (and location), from specific companies, or from all hiring companies that match the company filters.",
            "default": "companies"
          },
          "query": {
            "title": "Search",
            "type": "string",
            "description": "Optional free-text search over company names, one-liners and descriptions, e.g. <code>payments</code> or <code>AI agents</code>. Leave empty to list every company that matches the filters."
          },
          "batches": {
            "title": "Batches",
            "type": "array",
            "description": "YC batches, e.g. <code>Summer 2025</code>, <code>Winter 2024</code>, <code>Spring 2026</code>, <code>Fall 2025</code>. Short codes work too: <code>S25</code>, <code>W24</code>, <code>X26</code> (Spring), <code>F25</code> (Fall). Leave empty for all batches.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Industries or sub-industries as on ycombinator.com/companies, e.g. <code>B2B</code>, <code>Fintech</code>, <code>Healthcare</code>, <code>Engineering, Product and Design</code>, <code>Security</code>. A company matches if it has any of them.",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Company regions or countries, e.g. <code>United States of America</code>, <code>Europe</code>, <code>India</code>, <code>Latin America</code>, <code>Remote</code>, <code>Fully Remote</code>. A company matches if it has any of them.",
            "items": {
              "type": "string"
            }
          },
          "statuses": {
            "title": "Status",
            "type": "array",
            "description": "Only companies with any of these statuses. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Acquired",
                "Inactive",
                "Public"
              ],
              "enumTitles": [
                "Active",
                "Acquired",
                "Inactive",
                "Public"
              ]
            }
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Company tags, e.g. <code>Artificial Intelligence</code>, <code>Developer Tools</code>, <code>SaaS</code>, <code>Open Source</code>, <code>Robotics</code>. A company matches if it has any of them.",
            "items": {
              "type": "string"
            }
          },
          "hiringOnly": {
            "title": "Only companies that are hiring",
            "type": "boolean",
            "description": "Only companies with open jobs on YC's job board.",
            "default": false
          },
          "topCompaniesOnly": {
            "title": "Only YC top companies",
            "type": "boolean",
            "description": "Only companies on YC's Top Companies list.",
            "default": false
          },
          "minTeamSize": {
            "title": "Min team size",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at least this many employees."
          },
          "maxTeamSize": {
            "title": "Max team size",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at most this many employees."
          },
          "sortBy": {
            "title": "Sort companies by",
            "enum": [
              "relevance",
              "launchDate"
            ],
            "type": "string",
            "description": "Relevance: YC's default directory order. Launch date: newest launched companies first (ignored when Search is set).",
            "default": "relevance"
          },
          "jobRoles": {
            "title": "Job roles",
            "type": "array",
            "description": "Jobs mode: YC job board roles. Each role reads ycombinator.com/jobs/role/&lt;role&gt; (in the job location below, if set). Leave empty to use only company jobs pages, or all roles in the job location.",
            "items": {
              "type": "string",
              "enum": [
                "software-engineer",
                "designer",
                "product-manager",
                "recruiting-hr",
                "sales-manager",
                "marketing",
                "support",
                "operations",
                "science",
                "finance",
                "legal"
              ],
              "enumTitles": [
                "Software Engineer",
                "Design & UI/UX",
                "Product Manager",
                "Recruiting & HR",
                "Sales",
                "Marketing",
                "Support & Success",
                "Operations",
                "Science",
                "Finance",
                "Legal"
              ]
            }
          },
          "jobLocation": {
            "title": "Job location",
            "type": "string",
            "description": "Jobs mode: optional location for the role pages, e.g. <code>remote</code>, <code>san-francisco</code>, <code>new-york</code>, <code>los-angeles</code>, <code>seattle</code>, <code>boston</code>, <code>austin</code>, <code>london</code>, <code>india</code>. Leave empty for all locations."
          },
          "companySlugs": {
            "title": "Companies",
            "type": "array",
            "description": "Jobs mode: YC company slugs or URLs, e.g. <code>stripe</code> or <code>https://www.ycombinator.com/companies/airbnb</code>. Reads each company's jobs page.",
            "items": {
              "type": "string"
            }
          },
          "jobsFromFilteredCompanies": {
            "title": "Jobs at companies matching the company filters",
            "type": "boolean",
            "description": "Jobs mode: also read the jobs page of every hiring company that matches the company filters above (batch, industry, region, tags, ...), e.g. all open jobs at Summer 2025 startups. One page request per company.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many companies (Companies mode) or jobs (Jobs mode). Each item is billed as one event.",
            "default": 20
          },
          "onlyNew": {
            "title": "Only new items (monitoring)",
            "type": "boolean",
            "description": "Return only companies or jobs not returned by an earlier run with the same mode and filters. Schedule the actor (e.g. daily) for new-company or new-job alerts: the first run is a baseline, later runs output (and bill) only new items. State is kept in the key-value store \"ycombinator-companies-state\" in your account.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional Apify Proxy for ycombinator.com pages (usually not needed). The company search itself uses YC's public search API directly."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}