{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper — Companies, Founders, Jobs", "description": "Y Combinator startup directory data from ycombinator.com: company name, batch, status, stage, industry, region, tags, team size, website, location, hiring flag, founders, LinkedIn links and open jobs. Search by keyword, batch, industry, region or status. Pay per result, no login.", "version": "1.0", "x-build-id": "Zup8Xq1LcYbLwJg0h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/architekture~yc-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-architekture-yc-companies-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/architekture~yc-companies-scraper/runs": { "post": { "operationId": "runs-sync-architekture-yc-companies-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/architekture~yc-companies-scraper/run-sync": { "post": { "operationId": "run-sync-architekture-yc-companies-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 text", "type": "string", "description": "Search public YC company directory records. Empty searches all accessible matching records; upstream result windows may limit coverage." }, "batches": { "title": "Batches", "type": "array", "description": "Exact batch names as shown on ycombinator.com, e.g. 'Summer 2026', 'Winter 2025', 'Spring 2025'. Empty = all batches.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Industry facets, e.g. 'B2B', 'Consumer', 'Fintech', 'Healthcare', 'Industrials', 'Real Estate and Construction', 'Government', 'Education'. Sub-industries such as 'B2B -> Engineering, Product and Design' also work. Empty = all.", "items": { "type": "string" } }, "regions": { "title": "Regions / countries", "type": "array", "description": "Region facets, e.g. 'United States of America', 'Europe', 'India', 'Latin America', 'Canada', 'Remote'. Empty = all.", "items": { "type": "string" } }, "status": { "title": "Company status", "enum": [ "", "Active", "Inactive", "Acquired", "Public" ], "type": "string", "description": "Filter by current status.", "default": "" }, "isHiring": { "title": "Currently hiring only", "type": "boolean", "description": "Only companies with open roles on Work at a Startup.", "default": false }, "topCompaniesOnly": { "title": "YC Top Companies only", "type": "boolean", "description": "Only companies on YC's Top Companies list (highest valuation / revenue).", "default": false }, "sortNewest": { "title": "Newest first", "type": "boolean", "description": "Order by launch date (most recently launched first) instead of relevance.", "default": false }, "maxItems": { "title": "Max companies", "minimum": 0, "type": "integer", "description": "Maximum new unique companies per run. Default 500; 0 removes the actor cap, not upstream search limits.", "default": 500 }, "includeFounders": { "title": "Include founders, social links & open jobs", "type": "boolean", "description": "Fetch each company's YC page for founders (name, title, bio, LinkedIn, Twitter), company LinkedIn/Twitter/GitHub/Crunchbase, year founded, city/country and open job postings. One extra request per company, charged as company-detail.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional proxy configuration. Source availability and proxy suitability require live validation." }, "feedback": { "title": "Feedback for maintainers", "maxLength": 4000, "type": "string", "description": "Logged for human review; does not change output. Do not include credentials or personal information." }, "preview": { "title": "Free preview", "type": "boolean", "description": "20 lifetime attempts, one page and up to 10 basic company rows. Failed attempts count after reservation. Requires configured quota stores; no paid fallback.", "default": false }, "resumeState": { "title": "Continue collection", "type": "object", "description": "Paste the prior saved RESUME_STATE. Query, filters, sort and enrichment must match; maxItems may change. Dynamic results can move between runs." } } }, "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 } } } } } } } } } }