{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies & Founders Scraper", "description": "Y Combinator company directory scraper — batch, industry, hiring status, one-liner, description and founder names/titles/LinkedIn/Twitter for every YC-funded startup, one row per company.", "version": "0.1", "x-build-id": "fuBlAVEnPoBWeAbDH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatatools~yc-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatatools-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/webdatatools~yc-companies-scraper/runs": { "post": { "operationId": "runs-sync-webdatatools-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/webdatatools~yc-companies-scraper/run-sync": { "post": { "operationId": "run-sync-webdatatools-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": { "mode": { "title": "Mode", "enum": [ "companies", "search" ], "type": "string", "description": "Pick \"Browse companies\" to list/filter the directory by batch, industry, status or hiring status, or \"Search by keyword\" to additionally match the query text against each company's name and description.", "default": "companies" }, "query": { "title": "Search text", "type": "string", "description": "Enter keywords to match against the company name, one-liner and description, e.g. \"AI agents\". Only used when mode is \"Search by keyword\", or as an extra filter on top of the other fields in \"Browse companies\" mode. Leave empty to skip text search.", "default": "" }, "batches": { "title": "Batches", "type": "array", "description": "Enter YC batch codes to keep, e.g. W25, S25, F26. Leave empty to include every batch. Codes are case-insensitive and matched exactly against the company's batch field.", "default": [], "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Enter industry names to keep, e.g. B2B, Fintech, Healthcare. A company matches if it has at least one of the listed industries. Leave empty to include every industry.", "default": [], "items": { "type": "string" } }, "statuses": { "title": "Company statuses", "type": "array", "description": "Select which company statuses to keep. Leave empty to include every status (most companies are Active).", "items": { "type": "string", "enum": [ "Active", "Acquired", "Public", "Inactive" ], "enumTitles": [ "Active", "Acquired", "Public", "Inactive" ] }, "default": [] }, "isHiring": { "title": "Is hiring", "type": "boolean", "description": "Turn on to keep only companies currently marked as hiring on YC's directory, or leave this switch off (unset) to include both hiring and non-hiring companies. There is no third state for \"only non-hiring\" — untoggled means \"do not filter\"." }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Enter the maximum number of matching companies to return, e.g. 200. This is also the billed unit — the run stops as soon as it collects this many matches or runs out of companies to check.", "default": 50 }, "includeFounders": { "title": "Include founders", "type": "boolean", "description": "Keep this on to fetch each matched company's public YC profile page and extract founder name, title, LinkedIn and Twitter/X links. Turning it off skips one extra request per company and returns founders as null, which is much faster for large runs.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Enter how many HTTP requests (listing pages and founder profile pages) to run in parallel, e.g. 3. Raise it for faster large runs, lower it if you see request errors.", "default": 3 } } }, "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 } } } } } } } } } }