{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Directory + Startup Jobs Scraper", "version": "0.1", "x-build-id": "gQWEV9byA7g913K4Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arthursbuisness~y-combinator-companies-directory-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arthursbuisness-y-combinator-companies-directory-jobs", "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/arthursbuisness~y-combinator-companies-directory-jobs/runs": { "post": { "operationId": "runs-sync-arthursbuisness-y-combinator-companies-directory-jobs", "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/arthursbuisness~y-combinator-companies-directory-jobs/run-sync": { "post": { "operationId": "run-sync-arthursbuisness-y-combinator-companies-directory-jobs", "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 query (optional)", "type": "string", "description": "Free-text search over company name, one-liner, description and website — same search box as ycombinator.com/companies. Leave empty to list every company matching the filters." }, "batches": { "title": "Batches (optional)", "type": "array", "description": "YC batch names exactly as shown on the site, e.g. 'Summer 2025', 'Winter 2024', 'Spring 2025', 'Fall 2024'. Empty = all batches.", "items": { "type": "string" } }, "industries": { "title": "Industries (optional)", "type": "array", "description": "Industry or sub-industry names, e.g. 'B2B', 'Fintech', 'Healthcare', 'Consumer', 'Industrials', 'Education', 'Real Estate and Construction', 'Government', or sub-industries like 'Engineering, Product and Design', 'Infrastructure', 'Security'.", "items": { "type": "string" } }, "statuses": { "title": "Status (optional)", "type": "array", "description": "Company status: Active, Acquired, Public, Inactive. Empty = all.", "items": { "type": "string", "enum": [ "Active", "Acquired", "Public", "Inactive" ], "enumTitles": [ "Active", "Acquired", "Public", "Inactive" ] } }, "regions": { "title": "Regions (optional)", "type": "array", "description": "Region names as used by the directory, e.g. 'United States of America', 'Europe', 'United Kingdom', 'India', 'Latin America', 'Remote', 'Canada', 'Southeast Asia', 'Africa'.", "items": { "type": "string" } }, "tags": { "title": "Tags (optional)", "type": "array", "description": "Company tags such as 'AI', 'SaaS', 'Developer Tools', 'Marketplace', 'Fintech', 'Open Source', 'Climate', 'Hardware'.", "items": { "type": "string" } }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "Keep only companies with the 'Is hiring' flag in the directory.", "default": false }, "topCompaniesOnly": { "title": "Only YC Top Companies", "type": "boolean", "description": "Keep only companies YC lists as top companies by valuation/revenue.", "default": false }, "nonprofitOnly": { "title": "Only nonprofits", "type": "boolean", "description": "Keep only nonprofit companies.", "default": false }, "includeDetails": { "title": "Include company details (founders, socials, year founded)", "type": "boolean", "description": "Fetch each company's profile page for founders (name, title, bio, LinkedIn/X), LinkedIn/X/GitHub/Crunchbase links, city, country, year founded, YC partner and open-job count. One extra request per company (~2 per second).", "default": false }, "includeJobs": { "title": "Include open jobs", "type": "boolean", "description": "For every company that is hiring, also store one 'job' row per open position from its YC jobs page (title, location, type, role, salary and equity range, experience, visa sponsorship, skills, apply link). One extra request per hiring company.", "default": false }, "maxItems": { "title": "Max companies", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many companies (job rows are extra). The whole directory is about 6,000 companies.", "default": 1000 } } }, "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 } } } } } } } } } }