{ "openapi": "3.0.1", "info": { "title": "Y Combinator Founders Scraper", "description": "Extracts the full Y Combinator founders directory (~13,400) directly from the Algolia backend that powers ycombinator.com/founders. Fast, no browser.", "version": "0.1", "x-build-id": "1w2tTN7be5x572nJl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datacach~yc-founders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datacach-yc-founders-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/datacach~yc-founders-scraper/runs": { "post": { "operationId": "runs-sync-datacach-yc-founders-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/datacach~yc-founders-scraper/run-sync": { "post": { "operationId": "run-sync-datacach-yc-founders-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": { "query": { "title": "Search query", "type": "string", "description": "Optional full-text search term (founder name, company, etc.), exactly like the search box on the YC founders page. Leave it empty to return the whole directory (optionally narrowed by the filters below)." }, "topCompanyFoundersOnly": { "title": "Top company founders only", "type": "boolean", "description": "When enabled, returns only founders of companies YC flags as a \"top company\" (the \"Top Company Founder\" toggle on the site). When disabled (default), all founders are included.", "default": false }, "batches": { "title": "YC batches", "type": "array", "description": "YC batches to include, using the short codes shown on the site (e.g. \"S21\" = Summer 2021, \"W22\" = Winter 2022, \"F25\" = Fall 2025, \"P26\" = Spring 2026). Options are listed newest first. Leave empty to include all batches.", "items": { "type": "string", "enum": [ "W27", "F26", "S26", "P26", "W26", "F25", "S25", "P25", "W25", "F24", "S24", "W24", "S23", "W23", "S22", "W22", "S21", "W21", "S20", "W20", "S19", "W19", "S18", "W18", "S17", "W17", "S16", "W16", "S15", "W15", "S14", "W14", "S13", "W13", "S12", "W12", "S11", "W11", "S10", "W10", "S09", "W09", "S08", "W08", "S07", "W07", "S06", "W06", "S05" ], "enumTitles": [ "Winter 2027 (W27)", "Fall 2026 (F26)", "Summer 2026 (S26)", "Spring 2026 (P26)", "Winter 2026 (W26)", "Fall 2025 (F25)", "Summer 2025 (S25)", "Spring 2025 (P25)", "Winter 2025 (W25)", "Fall 2024 (F24)", "Summer 2024 (S24)", "Winter 2024 (W24)", "Summer 2023 (S23)", "Winter 2023 (W23)", "Summer 2022 (S22)", "Winter 2022 (W22)", "Summer 2021 (S21)", "Winter 2021 (W21)", "Summer 2020 (S20)", "Winter 2020 (W20)", "Summer 2019 (S19)", "Winter 2019 (W19)", "Summer 2018 (S18)", "Winter 2018 (W18)", "Summer 2017 (S17)", "Winter 2017 (W17)", "Summer 2016 (S16)", "Winter 2016 (W16)", "Summer 2015 (S15)", "Winter 2015 (W15)", "Summer 2014 (S14)", "Winter 2014 (W14)", "Summer 2013 (S13)", "Winter 2013 (W13)", "Summer 2012 (S12)", "Winter 2012 (W12)", "Summer 2011 (S11)", "Winter 2011 (W11)", "Summer 2010 (S10)", "Winter 2010 (W10)", "Summer 2009 (S09)", "Winter 2009 (W09)", "Summer 2008 (S08)", "Winter 2008 (W08)", "Summer 2007 (S07)", "Winter 2007 (W07)", "Summer 2006 (S06)", "Winter 2006 (W06)", "Summer 2005 (S05)" ] }, "default": [] }, "industries": { "title": "YC company industries", "type": "array", "description": "Top-level industry of the founder's company (the 9 broad sectors YC groups companies into). Leave empty to include all. Use \"Subindustries\" below for finer-grained categories.", "items": { "type": "string", "enum": [ "B2B", "Consumer", "Education", "Fintech", "Government", "Healthcare", "Industrials", "Real Estate and Construction", "Unspecified" ] }, "default": [] }, "subindustries": { "title": "YC company subindustries", "type": "array", "description": "Fine-grained category of the founder's company (e.g. \"Payments\", \"Security\", \"Healthcare IT\") — the subcategories revealed by \"See all options\" under Industry on the site. Leave empty to include all.", "items": { "type": "string", "enum": [ "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", "Unspecified", "Virtual and Augmented Reality" ] }, "default": [] }, "roles": { "title": "YC company roles / titles", "type": "array", "description": "Founder's title at their current company, matching the \"YC Company Role\" filter (e.g. \"Founder\", \"CEO\", \"CTO\", \"Co-Founder\", \"COO\"). These are raw, free-text titles taken straight from founder profiles, so the list is long and includes many inconsistent or unusual variants. Leave empty to include all roles.", "items": { "type": "string", "enum": [ "Founder", "CEO", "CTO", "Co-Founder", "COO", "Co-founder & CEO", "Founder/CEO", "Founder & CEO", "Co-founder & CTO", "Founder/CTO", "CPO", "CEO & Co-Founder", "President", "Co-Founder and CEO", "Co-Founder and CTO", "Founder & CTO", "Founder and CEO", "Co-Founder, CEO", "Co-Founder, CTO", "Founder / CEO", "Founder, CEO", "CMO", "CSO", "Co-founder/CEO", "Co-Founder / CEO", "CTO & Co-Founder", "CEO & Founder", "Co-Founder / CTO", "Cofounder", "Head of Product", "CEO, Co-Founder", "Co-Founder & COO", "Cofounder & CEO", "Director", "Founder, CTO", "Software Engineer", "Chief Technical Officer", "Co-Founder, COO", "Developer", "Engineer", "Founder/COO", "Founder/President", "Founding CEO", "Board Member", "CEO and Co-Founder", "CEO and Founder", "CFO", "Chief Scientist", "Co-Founder & President", "Co-Founder/CTO", "Cofounder & CTO", "Cofounder/CTO", "Designer", "Founder / CTO", "Founder and CTO", "Founder/CPO", "Technical", "CCO", "CEO / Co-Founder", "CEO/Co-Founder", "CEO/Founder", "Chief Design Officer", "Chief Medical Officer", "Chief Scientific Officer", "CIO", "Co-CEO", "Co-founder & CPO", "Cofounder / CTO", "Cofounder and CTO", "Cofounder, CEO", "Cofounder/CEO", "COO & Co-Founder", "CTO, Co-Founder", "Founder + CEO", "Founder - CEO", "Founder CEO", "Founder/CSO", "Head of Growth", "Software Developer", "Vice President of Engineering", "Vice President of Product", "| CTO", "(YC S16)", "Business Development", "CEO & President", "CEO / Founder", "CEO and Cofounder", "CEO, Founder", "CEO/CTO", "CFO/COO", "Chairman", "Chairman & Founding CEO", "Chief Customer Officer", "Chief Engineer", "Chief Software Architect", "Co Founder", "Co-Founder & CBO", "Co-Founder (CTO)", "Co-Founder + CTO", "Co-Founder / COO", "Co-founder and President", "Co-Founder CTO", "Co-Founder, Co-CEO", "Co-Founder, CPO", "Co-Founder/COO", "Cofounder and CEO", "Cofounder, CTO", "CTO (YC S16)", "CTO / Founder", "CTO and Co-Founder", "Director of Engineering", "Entrepreneur", "Executive Director", "Founder & COO", "Founder (acquired)", "Founder / CPO", "Founder and COO", "Founder, CPO", "Founder/Chairman", "Founder/Co-CEO", "Founder/Founding CEO", "Founding Engineer", "Head of Business Development", "Head of Design", "Head of Engineering", "Head of Operations", "Lead Engineer", "Operations", "Owner", "Partner", "Product Manager", "Vice President Engineering", "| CEO", "(Product & Growth)", "(YC S08)", "; Empowering Gusto's Product and Design Teams", "Advisor", "Artistic Director", "at KidPass", "Board Director", "Business Development & Growth", "CBO", "CEO & Cofounder", "CEO (YC S16)", "CEO + co-founder", "CEO / Designer (Acquired by Coinbase)", "CEO and Chief Designer", "CEO, , President", "CEO, Cofounder", "CEO, Engineer", "CEO/ Co-Founder", "CEO/, Programmer", "CEO/Chairman", "CEO/President", "CEOM", "CFO & Cofounder", "CFO / Head of Business Development", "Chairman & CEO", "Chairman & Founder", "Chief Actuary", "Chief Bottle Washer", "Chief Content Officer", "Chief Creative Officer", "Chief Data Officer", "Chief Data Scientist", "Chief Designer", "Chief Executive Officer ()", "Chief Growth Officer", "Chief Marketing & Business Development Officer", "Chief Marketing Officer and Chief Product Officer", "Chief Medical and Technology Officer", "Chief Nutrition Scientist", "Chief of Product", "Chief Operations Officer", "Chief Platform Officer", "Chief Science Officer", "Chief Scout", "Chief Strategy Officer", "Chief Technology Officer (CTO)", "Co", "Co & Chief Operating Officer", "Co-designer", "Co-founder & Chief AI Officer", "Co-founder & Co-CEO", "Co-Founder & CRO", "Co-Founder & Head of Design", "Co-Founder & Head of ML", "Co-Founder & Head of Product", "Co-Founder & VP of Engineering", "Co-founder (Design, Product, Front-End)", "Co-Founder and COO", "Co-Founder CEO", "Co-Founder, AI", "Co-founder, CEO (Acq. by Avara Labs)", "Co-Founder, Co-Chief Executive Officer", "Co-Founder, CPO/Marketing", "Co-founder, President", "Co-Founder, VP Product and User Experience", "Co-Founder/ CEO", "Co-Founder/ CTO", "Co-Founder/Head of Finance", "Co-Fundador, CEO", "Cofounder & President", "Cofounder CTO", "Cofounder | CTO", "Cofounder, CEO (acquired by LaunchDarkly)", "COO & Founder", "COO & Head of Product", "COO (Acq By Goldman Sachs)", "COO - YC W15", "COO / Founder", "COO, and Head of Product", "COO, Software Engineer", "CPO & COO", "CPO + CMO", "CPO/Product Lead", "Creative Director", "CRO", "CRO & Co-Founder", "CTO / Co-Founder", "CTO / Co-Founder", "CTO / CPO", "CTO / Developer", "CTO / Vice President Engineering", "CTO and Cloud Architect", "CTO and Vice President of Engineering", "CTO at Medinas", "CTO, Vice President of Engineering (FinTech)", "CTO/Co-founder", "CTO/Head of Engineering", "CTO/Lead Engineer - Javascript (Ember), Ruby (Rails), React Native", "CVO", "Design", "Design Director", "Design Lead", "Designer, Developer", "Developer Evangelist", "developer, tech dude", "Director of Engineering (Logistics)", "Director of Marketing", "Director of Operations", "Director of Product", "Director of Research and Partnerships", "Director of Strategy", "Early employee \"bootstrapping\" days", "Empowering Gusto's Engineering Team", "Ex-CEO & Co-founder (Previously CTO)", "ex-Founder", "Executive Business Advisor", "Executive Chair", "Executive Chairman", "Executive Partner", "Former Co-Founder", "Founder & Chief Hardware Architect", "Founder & Chief Scientist", "Founder & Chief Technology Officer", "Founder & CMO", "Founder & CPO", "Founder & Head of AI", "Founder & President", "Founder (COO)", "Founder + CTO", "Founder - CTO", "Founder / COO", "Founder / COO / CCO / GM", "Founder / President", "Founder and CTO (YC S21)", "Founder | CEO", "Founder | COO: Product Innovation & GTM Lead", "Founder | CTO", "Founder& CTO", "Founder, COO & CTO", "Founder, Head of Design", "Founder, Head of Mobile & Design", "Founder, President, Head of Operations, Sales & Customer Success", "Founder, Сhair of the Board", "Founder/ Co-CEO", "Founder/ CTO", "Founder/Board Director", "Founder/Building", "Founder/CCO", "Founder/CEO & CTO", "Founder/CEO (YC S15)", "Founder/CEO and Board Chair", "Founder/CEO, at Impraise", "Founder/Chief Medical Officer", "Founder/Chief of Product", "Founder/CTO/CPO", "Founder/Head of Business", "Founder/Head of Product and Content", "Founder/Operating Director", "Founder/Problem Solver in Chief", "Founder/| CEO", "Founder; COO", "Founding CEO, Founder", "Founding Director", "Full Stack Web Developer", "Full-stack Developer", "Growth", "Growth Marketing", "Growth, Product & Ops", "Hardware Design and Fabrication Engineer", "Head Barista", "Head of Business and Growth", "Head of Data-Science", "Head of Direction", "Head of Effective Altruism Grants and Individual Outreach", "Head of Eng", "Head of Engineer", "Head of Finance & Operations ()", "Head of Financial Planning", "Head of Hardware Engineering", "Head of Marketing", "Head of Marketing and Operations", "Head of Operations and Marketing", "Head of Product & Partner", "Head of Product Design & Marketing", "Head of Robotics", "Head of Sales", "Head of Software", "Head of Trust and Safety", "interaction designer", "iOS Developer", "iTech #1", "Labor Management, Harvest Management, & Traceability", "Lead Architect", "Lead Designer", "Lead Developer", "Lead Hardware Engineer", "Lead Infrastructure Engineer", "Lead Instructor", "Lead Technical Architect", "Lead Web Developer", "Lightspeed summer fellow '13", "Magician, Taster & CTO", "Managing Director", "Managing Partner", "Mechanical and Embedded Systems Lead", "Not Active", "of Lilu and Chief Design Officer", "Operations & Sales", "PadMapper, Inc", "Partner, Developer", "Patient Advocate", "President & CEO", "President & CEO; Chairman of the Board", "President & Chief Science Officer", "President & Co-Founder", "President and CEO", "President and COO", "President of R&D", "President, CTO", "Principal", "Principal Software Engineer", "Product", "Product & Engineering", "Product + Technology", "Product Architect", "Product Development / UX lead", "Product Economist", "product engineer", "Product Lead", "Product Management", "Product Manager, Software Engineer", "Project Lead", "R&D Director", "Retired", "Science Consultant", "Senior Scientist", "Senior Software Engineer", "Senior Vice President Product", "Shypmate", "Software Architect", "Software Developer / Program Manager", "Software Engineer & CTO", "Software Engineer / Product Manager", "Software lead", "Strategy, Marketing", "Team Member", "Tech", "Technical /CTO", "Technology", "The Science Guy", "The Water Guy", "Title", "US Executive Director", "User Experience Director", "Vice President Customer Success", "Vice President of Customer Success", "Vice President of Genomics", "Vice President of Operations", "Vice President of Product Development and Engineering", "Vice President of Sales and Business Developement", "Vice President of Technology", "Vice President Operations", "Vice President Operations & Business Development", "Vice President Product |", "Vice President QA/RA", "Vice President R&D", "Vice President Technology", "Vice President, Customer Success", "VP Product & Patient Experience", "Zookeeper's Assistant", "| Growth and Strategy", "| Vice President of Business Development", "|CEO" ] }, "default": [] }, "regions": { "title": "Founder regions", "type": "array", "description": "Founder's current country/region. Not shown in the site sidebar, but exposed by the backend and included here for convenience. Leave empty to include all regions.", "items": { "type": "string", "enum": [ "Albania", "Algeria", "Andorra", "Argentina", "Armenia", "Australia", "Austria", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Benin", "Bermuda", "Bolivia", "Brazil", "Bulgaria", "Cameroon", "Canada", "Cayman Islands", "Chile", "China", "Colombia", "Costa Rica", "Croatia", "Cyprus", "Czechia", "Denmark", "Ecuador", "Egypt", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iraq", "Ireland", "Israel", "Italy", "Ivory Coast", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kyrgyzstan", "Latvia", "Lithuania", "Luxembourg", "Macau", "Malaysia", "Malta", "Mexico", "Monaco", "Morocco", "Nepal", "Netherlands", "New Zealand", "Nigeria", "Norway", "Oman", "Pakistan", "Panama", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sweden", "Switzerland", "Taiwan", "Tanzania", "Thailand", "Turkey", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Virgin Islands", "United States of America", "Unspecified", "Uruguay", "Venezuela", "Vietnam", "Zambia" ] }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of founders to store in the dataset. Set to 0 (default) for no limit — this returns the entire matching selection, up to the full directory of ~13,400 founders. Free plan is capped at 10 founders regardless of this value; upgrade to a paid plan to remove the limit.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of parallel requests sent to the Algolia backend. 8-16 is fast and polite; lower it if you hit rate limits.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Not needed for this Actor — the Algolia backend has no anti-bot protection — so you can safely leave it disabled.", "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 } } }, "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 } } } } } } } } } }