{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Startup Directory with Founders & Jobs",
    "description": "Search Y Combinator's company directory by batch, industry, status, or keyword, and get each company's profile, founders, and open job postings. No login required.",
    "version": "1.0",
    "x-build-id": "u3s5u8dLqnytfJXXx"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dataspryva~y-combinator-startup-directory-with-founders/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dataspryva-y-combinator-startup-directory-with-founders",
        "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/dataspryva~y-combinator-startup-directory-with-founders/runs": {
      "post": {
        "operationId": "runs-sync-dataspryva-y-combinator-startup-directory-with-founders",
        "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/dataspryva~y-combinator-startup-directory-with-founders/run-sync": {
      "post": {
        "operationId": "run-sync-dataspryva-y-combinator-startup-directory-with-founders",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byCompany"
            ],
            "type": "string",
            "description": "search filters the directory; byCompany fetches the exact companies in companyUrls.",
            "default": "search"
          },
          "searchQuery": {
            "title": "Search Query",
            "type": "string",
            "description": "Free-text relevance search across company names, descriptions and tags (mode=search)."
          },
          "batch": {
            "title": "Batch",
            "enum": [
              "any",
              "S05",
              "W06",
              "S06",
              "W07",
              "S07",
              "W08",
              "S08",
              "W09",
              "S09",
              "W10",
              "S10",
              "W11",
              "S11",
              "W12",
              "S12",
              "W13",
              "S13",
              "W14",
              "S14",
              "W15",
              "S15",
              "W16",
              "S16",
              "W17",
              "S17",
              "W18",
              "S18",
              "W19",
              "S19",
              "W20",
              "S20",
              "W21",
              "S21",
              "W22",
              "S22",
              "W23",
              "S23",
              "W24",
              "S24",
              "F24",
              "W25",
              "P25",
              "S25",
              "F25",
              "W26",
              "P26",
              "S26",
              "F26",
              "W27",
              "S27"
            ],
            "type": "string",
            "description": "YC batch. P = Spring, S = Summer, W = Winter, F = Fall. 'any' includes every batch.",
            "default": "any"
          },
          "industry": {
            "title": "Industry",
            "enum": [
              "any",
              "Agriculture",
              "Analytics",
              "Apparel and Cosmetics",
              "Asset Management",
              "Automotive",
              "Aviation and Space",
              "B2B",
              "Banking and Exchange",
              "Climate",
              "Construction",
              "Consumer",
              "Consumer Electronics",
              "Consumer Finance",
              "Consumer Health and Wellness",
              "Content",
              "Credit and Lending",
              "Defense",
              "Diagnostics",
              "Drones",
              "Drug Discovery and Delivery",
              "Education",
              "Energy",
              "Engineering, Product and Design",
              "Finance and Accounting",
              "Fintech",
              "Food and Beverage",
              "Gaming",
              "Government",
              "Healthcare",
              "Healthcare IT",
              "Healthcare Services",
              "Home and Personal",
              "Housing and Real Estate",
              "Human Resources",
              "Industrial Bio",
              "Industrials",
              "Infrastructure",
              "Insurance",
              "Job and Career Services",
              "Legal",
              "Manufacturing and Robotics",
              "Marketing",
              "Medical Devices",
              "Office Management",
              "Operations",
              "Payments",
              "Productivity",
              "Real Estate and Construction",
              "Recruiting and Talent",
              "Retail",
              "Sales",
              "Security",
              "Social",
              "Supply Chain and Logistics",
              "Therapeutics",
              "Transportation Services",
              "Travel, Leisure and Tourism",
              "Virtual and Augmented Reality"
            ],
            "type": "string",
            "description": "Exact YC industry facet. 'any' includes every industry.",
            "default": "any"
          },
          "region": {
            "title": "Region",
            "enum": [
              "any",
              "Africa",
              "Algeria",
              "America / Canada",
              "Argentina",
              "Asia",
              "Australia",
              "Austria",
              "Bahrain",
              "Bangladesh",
              "Belarus",
              "Belgium",
              "Brazil",
              "Bulgaria",
              "Canada",
              "Cayman Islands",
              "Chile",
              "China",
              "Colombia",
              "Costa Rica",
              "Croatia",
              "Cyprus",
              "Czechia",
              "Democratic Republic of the Congo",
              "Denmark",
              "East Asia",
              "Ecuador",
              "Egypt",
              "Estonia",
              "Ethiopia",
              "Europe",
              "Finland",
              "France",
              "Fully Remote",
              "Georgia",
              "Germany",
              "Ghana",
              "Greece",
              "Hong Kong",
              "Hungary",
              "Iceland",
              "India",
              "Indonesia",
              "Iraq",
              "Ireland",
              "Israel",
              "Italy",
              "Ivory Coast",
              "Japan",
              "Jordan",
              "Kenya",
              "Kyrgyzstan",
              "Latin America",
              "Latvia",
              "Lithuania",
              "Malaysia",
              "Mexico",
              "Middle East and North Africa",
              "Morocco",
              "Namibia",
              "Nepal",
              "Netherlands",
              "New Zealand",
              "Nigeria",
              "Norway",
              "Oceania",
              "Pakistan",
              "Panama",
              "Partly Remote",
              "Peru",
              "Philippines",
              "Poland",
              "Portugal",
              "Puerto Rico",
              "Remote",
              "Romania",
              "Russia",
              "Saudi Arabia",
              "Senegal",
              "Seychelles",
              "Singapore",
              "Slovenia",
              "South Africa",
              "South Asia",
              "South Korea",
              "Southeast Asia",
              "Spain",
              "Sweden",
              "Switzerland",
              "Taiwan",
              "Tanzania",
              "Thailand",
              "Turkey",
              "Uganda",
              "Ukraine",
              "United Arab Emirates",
              "United Kingdom",
              "United States of America",
              "Uruguay",
              "Venezuela",
              "Vietnam",
              "Zambia"
            ],
            "type": "string",
            "description": "Exact YC region facet. 'any' includes every region.",
            "default": "any"
          },
          "status": {
            "title": "Status",
            "enum": [
              "any",
              "Active",
              "Inactive",
              "Acquired",
              "Public"
            ],
            "type": "string",
            "description": "Company operating status. 'any' includes every status.",
            "default": "any"
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Exact YC tags; any one match is enough. Common tags: AI, B2B, SaaS, Fintech, Developer Tools, Marketplace, Generative AI, Consumer, Machine Learning, E-commerce, Healthcare, Analytics, Hardware, Open Source, Health Tech, Productivity, Education, AI Assistant, Robotics, Infrastructure.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "isHiring": {
            "title": "Hiring Only",
            "type": "boolean",
            "description": "Only companies carrying YC's Is Hiring badge.",
            "default": false
          },
          "topCompany": {
            "title": "Top Companies Only",
            "type": "boolean",
            "description": "Only companies carrying YC's Top Company badge.",
            "default": false
          },
          "nonprofit": {
            "title": "Nonprofits Only",
            "type": "boolean",
            "description": "Only companies carrying YC's Nonprofit badge.",
            "default": false
          },
          "highlightBlackFounders": {
            "title": "Black Founders",
            "type": "boolean",
            "description": "Only companies YC flags as having Black founders.",
            "default": false
          },
          "highlightWomenFounders": {
            "title": "Women Founders",
            "type": "boolean",
            "description": "Only companies YC flags as having women founders.",
            "default": false
          },
          "highlightHispanicFounders": {
            "title": "Hispanic / Latino Founders",
            "type": "boolean",
            "description": "Only companies YC flags as having Hispanic or Latino founders.",
            "default": false
          },
          "minTeamSize": {
            "title": "Minimum Team Size",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop companies with fewer employees. Companies reporting 0 (unknown) are excluded."
          },
          "maxTeamSize": {
            "title": "Maximum Team Size",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop companies with more employees. Companies reporting 0 (unknown) are excluded."
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "default",
              "launchDate"
            ],
            "type": "string",
            "description": "Directory order follows YC relevance; launchDate puts the newest directory launches first.",
            "default": "default"
          },
          "companyUrls": {
            "title": "Company URLs or Slugs",
            "type": "array",
            "description": "Companies to fetch (mode=byCompany). Accepts full ycombinator.com/companies URLs, /companies/<slug> paths or bare slugs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "scrapeFounders": {
            "title": "Include Founders",
            "type": "boolean",
            "description": "Add each company's founders with title, bio, LinkedIn, X and profile link. Uses the company page already fetched for the record.",
            "default": true
          },
          "scrapeOpenJobs": {
            "title": "Include Open Jobs",
            "type": "boolean",
            "description": "Add current job postings with salary and equity ranges, experience, visa, skills and remote signal.",
            "default": true
          },
          "includeJobDescriptions": {
            "title": "Include Job Descriptions",
            "type": "boolean",
            "description": "Fetch one extra page per job for its full description, interview process and hiring manager.",
            "default": false
          },
          "includeLaunches": {
            "title": "Include Launch YC Posts",
            "type": "boolean",
            "description": "Add Launch YC post metadata (title, tagline, date, votes, link).",
            "default": true
          },
          "includeLaunchBodies": {
            "title": "Include Launch Bodies",
            "type": "boolean",
            "description": "Add the full text of each Launch YC post. Makes records much larger.",
            "default": false
          },
          "includeNews": {
            "title": "Include News",
            "type": "boolean",
            "description": "Add news items linked from the company page.",
            "default": false
          },
          "includeFounderProfiles": {
            "title": "Include Founder Profiles",
            "type": "boolean",
            "description": "Fetch one extra page per founder for previous roles, schools and current title.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum Companies",
            "minimum": 1,
            "maximum": 7000,
            "type": "integer",
            "description": "Stop after this many companies. Applied after filters and before detail pages.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}