{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Scraper - YC Startup Directory", "description": "Export the Y Combinator startup directory (6,000+ companies): filter by batch, industry, region, status, hiring and team size. Optional company details: founding year, company socials, open jobs, founder names. Only-new mode for new-batch alerts.", "version": "0.1", "x-build-id": "YZi1oPmpSfwarodHu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~ycombinator-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-ycombinator-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/rjmacarthy~ycombinator-companies-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-ycombinator-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/rjmacarthy~ycombinator-companies-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-ycombinator-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": "Free-text search over company names, one-liners and descriptions, like the search box on ycombinator.com/companies (e.g. \"AI agents\", \"payments\"). Leave empty to list everything that matches the filters.", "default": "" }, "batches": { "title": "Batches", "type": "array", "description": "YC batches to include. Full names (\"Summer 2025\") or YC's short form (\"S25\", \"W24\", \"X25\" = Spring 2025, \"F24\" = Fall 2024). Empty = all batches.", "default": [], "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Industries or sub-industries as shown in the directory filter, e.g. \"Fintech\", \"Healthcare\", \"B2B\", \"Payments\", \"Security\". Case-insensitive. A company matches if it has any of them.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Regions or countries as shown in the directory filter, e.g. \"United States of America\", \"Europe\", \"India\", \"Remote\". Case-insensitive. A company matches if it has any of them.", "default": [], "items": { "type": "string" } }, "statuses": { "title": "Company status", "type": "array", "description": "Only companies with one of these statuses. Empty = all.", "items": { "type": "string", "enum": [ "Active", "Acquired", "Public", "Inactive" ], "enumTitles": [ "Active", "Acquired", "Public", "Inactive" ] }, "default": [] }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "Only companies with open jobs on Work at a Startup.", "default": false }, "topCompaniesOnly": { "title": "Only YC top companies", "type": "boolean", "description": "Only companies on YC's Top Companies list.", "default": false }, "nonprofit": { "title": "Only nonprofits", "type": "boolean", "description": "Only nonprofit organisations.", "default": false }, "teamSizeMin": { "title": "Minimum team size", "minimum": 0, "type": "integer", "description": "Only companies with at least this many employees (as listed on YC). Empty = no minimum." }, "teamSizeMax": { "title": "Maximum team size", "minimum": 0, "type": "integer", "description": "Only companies with at most this many employees. Empty = no maximum." }, "startUrls": { "title": "Company URLs", "type": "array", "description": "Look up specific companies instead of searching: YC company URLs such as https://www.ycombinator.com/companies/airbnb (or just the slug \"airbnb\"). When set, the search text and filters above are ignored.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max companies", "minimum": 0, "type": "integer", "description": "Stop after this many companies. 0 = no limit (the whole directory is about 6,400 companies).", "default": 100 }, "fetchDetails": { "title": "Fetch company details", "type": "boolean", "description": "Also open each company's YC page to add the founding year, the company's own LinkedIn / X (Twitter) / Facebook / Crunchbase / GitHub links, open jobs (title, URL, location, salary range) and founders' names and titles. Charged as an extra 'company-details' event per company. Founders' personal profiles, bios and contact details are never collected.", "default": false }, "onlyNew": { "title": "Only new companies", "type": "boolean", "description": "Remember which companies were already output and only output (and charge for) companies that are new since the previous run with the same state key. The first run outputs the current matches (up to Max companies) as the baseline - set Max companies to 0 on that run so later runs don't report old companies as new. Ideal for scheduled alerts on new batch members.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Name of the 'seen companies' memory used by Only new companies. Use a different key for each monitor (e.g. \"s26-fintech\").", "default": "default" }, "maxRequestsPerSecond": { "title": "Max requests per second", "minimum": 1, "maximum": 10, "type": "integer", "description": "Politeness limit per host (company pages and the search API). The default is fine for most runs.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed normally. Enable Apify Proxy (datacenter) if ycombinator.com blocks or rate-limits your runs. Residential proxies are not supported: if you pick the RESIDENTIAL group the Actor logs a warning and uses Apify datacenter proxy instead.", "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 }, "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 } } } } } } } } } }