{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper", "description": "[💰 $2.0 / 1K] Extract YC-funded companies, founders, and open jobs from the Y Combinator startup directory. Filter by batch, industry, region, status, team size, or hiring activity — or paste any directory URL with filters pre-applied.", "version": "1.0", "x-build-id": "HLVW08ys6AsdstheP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~ycombinator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-ycombinator-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/solidcode~ycombinator-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-ycombinator-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/solidcode~ycombinator-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-ycombinator-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": { "startUrls": { "title": "YC Directory or Company URLs", "type": "array", "description": "Paste one or more Y Combinator URLs. Accepts directory pages with filters pre-applied (e.g. https://www.ycombinator.com/companies?batch=W24&industry=B2B), individual company URLs (https://www.ycombinator.com/companies/airbnb), or a mix. Leave empty to use the guided filters below — or to scrape the full unfiltered directory if no filters are set.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Optional free-text search across the YC directory (matches the search box on ycombinator.com/companies). Combines with the filters below." }, "batches": { "title": "YC Batches", "uniqueItems": true, "type": "array", "description": "Funding cohorts to include. Multi-select. Leave empty to include all batches.", "items": { "type": "string", "enum": [ "F25", "S25", "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", "IK12" ], "enumTitles": [ "Fall 2025", "Summer 2025", "Winter 2025", "Fall 2024", "Summer 2024", "Winter 2024", "Summer 2023", "Winter 2023", "Summer 2022", "Winter 2022", "Summer 2021", "Winter 2021", "Summer 2020", "Winter 2020", "Summer 2019", "Winter 2019", "Summer 2018", "Winter 2018", "Summer 2017", "Winter 2017", "Summer 2016", "Winter 2016", "Summer 2015", "Winter 2015", "Summer 2014", "Winter 2014", "Summer 2013", "Winter 2013", "Summer 2012", "Winter 2012", "Summer 2011", "Winter 2011", "Summer 2010", "Winter 2010", "Summer 2009", "Winter 2009", "Summer 2008", "Winter 2008", "Summer 2007", "Winter 2007", "Summer 2006", "Winter 2006", "Summer 2005", "Imagine K12" ] }, "default": [] }, "status": { "title": "Company Status", "uniqueItems": true, "type": "array", "description": "Operating status. Multi-select. Leave empty for all statuses.", "items": { "type": "string", "enum": [ "Active", "Public", "Acquired", "Inactive" ], "enumTitles": [ "Active", "Public", "Acquired", "Inactive" ] }, "default": [] }, "regions": { "title": "Regions", "uniqueItems": true, "type": "array", "description": "Headquarters region. Multi-select. Leave empty for all regions.", "items": { "type": "string", "enum": [ "United States of America", "Canada", "Latin America", "Europe", "United Kingdom", "Asia", "India", "Africa", "Middle East", "Oceania", "Remote" ], "enumTitles": [ "United States", "Canada", "Latin America", "Europe", "United Kingdom", "Asia", "India", "Africa", "Middle East", "Oceania", "Remote" ] }, "default": [] }, "industries": { "title": "Industries", "uniqueItems": true, "type": "array", "description": "Industry vertical. Multi-select. Leave empty for all industries.", "items": { "type": "string", "enum": [ "B2B", "Consumer", "Education", "Fintech", "Government", "Healthcare", "Industrials", "Real Estate and Construction" ], "enumTitles": [ "B2B", "Consumer", "Education", "Fintech", "Government", "Healthcare", "Industrials", "Real Estate and Construction" ] }, "default": [] }, "teamSize": { "title": "Team Size", "uniqueItems": true, "type": "array", "description": "Self-reported employee count. Multi-select. Leave empty for any size.", "items": { "type": "string", "enum": [ "1", "2-10", "11-50", "51-200", "201-500", "500+" ], "enumTitles": [ "1 (solo founder)", "2 to 10", "11 to 50", "51 to 200", "201 to 500", "500+" ] }, "default": [] }, "isHiring": { "title": "Hiring Only", "type": "boolean", "description": "If on, return only companies with at least one open job listed on YC. Useful for recruiting and lead generation.", "default": false }, "includeFounders": { "title": "Include Founders", "type": "boolean", "description": "Embed each company's founders on the result row — name, title, bio, LinkedIn, and X. Disable for faster, cheaper runs that return only company-level data. (Note: Y Combinator does not publish founder emails publicly — `email` and `emailStatus` are always null.)", "default": true }, "includeJobs": { "title": "Include Open Jobs", "type": "boolean", "description": "Embed each company's open job listings on the result row — title, location, remote, salary, equity, required skills, years of experience, and visa sponsorship. Disable when you only need company and founder data. (Tip: turn off both Founders and Jobs for the fastest, cheapest runs — only company-level fields are returned.)", "default": false }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Hard cap on total company rows. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 10,000 still applies to prevent runaway pagination). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 100 } } }, "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 } } } } } } } } } }