{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper - YC Companies Directory", "description": "Scrape Y Combinator companies without login. Export the YC startup directory to CSV/JSON, an unofficial API alternative with founders and LinkedIn.", "version": "0.0", "x-build-id": "Bu1PLNeEErnQqMfDh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~y-combinator-companies-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-y-combinator-companies-directory-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/logiover~y-combinator-companies-directory-scraper/runs": { "post": { "operationId": "runs-sync-logiover-y-combinator-companies-directory-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/logiover~y-combinator-companies-directory-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-y-combinator-companies-directory-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": { "batch": { "title": "Batch", "enum": [ "", "Winter 2027", "Fall 2026", "Summer 2026", "Spring 2026", "Winter 2026", "Fall 2025", "Summer 2025", "Spring 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" ], "type": "string", "description": "Only companies from this YC batch. Leave as \"Any batch\" to include every batch from 2005 to today.", "default": "" }, "industry": { "title": "Industry", "enum": [ "", "B2B", "Consumer", "Education", "Fintech", "Government", "Healthcare", "Industrials", "Real Estate and Construction", "Unspecified" ], "type": "string", "description": "Only companies in this top-level YC industry. Leave as \"Any industry\" for all.", "default": "" }, "status": { "title": "Status", "enum": [ "", "Active", "Acquired", "Public", "Inactive" ], "type": "string", "description": "Only companies with this operating status. Leave as \"Any status\" for all.", "default": "" }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "When ON, return only companies currently marked as hiring on YC.", "default": false }, "searchQuery": { "title": "Free-text Search", "type": "string", "description": "Optional. Substring search across company name + one-liner + long description (e.g. \"developer tools\", \"climate\").", "default": "" }, "filters": { "title": "Advanced filters (optional)", "type": "object", "description": "Extra filters AND-combined with the dropdowns above. Supported keys: batch, status, industry, subindustry, location, country, minTeamSize, maxTeamSize, isHiring, tags[]. Leave empty to return the whole directory." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap returned companies. Leave the default for a fast, broad sample; raise it (up to 10000) to export the entire directory (~6000 companies).", "default": 200 }, "fetchCompanyPageDetails": { "title": "Fetch Company Page Details (founders, socials)", "type": "boolean", "description": "When enabled, scrapes each individual YC company page for founders (name, role, LinkedIn, Twitter, email if shown) and full launch posts. Adds one HTTP request per company, so keep maxResults modest when using it.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The company directory is a public JSON API and works without a proxy; a proxy only helps when fetching many individual company pages.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }