{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper - YC Companies, Founders & Startup Jobs", "description": "Scrape the Y Combinator startup directory by batch, industry, region, team size, status, tags or keyword: company profiles with social links, the founders shown on each company page, and open jobs with salary, equity and posting date.", "version": "0.1", "x-build-id": "SgKyf7s1LTFrQoMQf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~ycombinator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-ycombinator-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/automly~ycombinator-scraper/runs": { "post": { "operationId": "runs-sync-automly-ycombinator-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/automly~ycombinator-scraper/run-sync": { "post": { "operationId": "run-sync-automly-ycombinator-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": { "dataType": { "title": "What to scrape", "enum": [ "companies", "founders", "jobs" ], "type": "string", "description": "Companies: one row per company. Founders: one row per founder shown on each company page. Jobs: one row per open job at the companies found.", "default": "companies" }, "search": { "title": "Keyword", "type": "string", "description": "Words to search company names and descriptions for, like \"developer tools\" or \"ai agents\". Leave empty to list every company that matches the filters." }, "batches": { "title": "Batches", "type": "array", "description": "Y Combinator batches, like \"Winter 2025\", \"Summer 2024\" or the short form W25, S24, F25 (Fall), P26 (Spring).", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Main industries to include.", "items": { "type": "string", "enum": [ "B2B", "Consumer", "Healthcare", "Fintech", "Industrials", "Real Estate and Construction", "Education", "Government" ] } }, "subindustries": { "title": "Sub-industries", "type": "array", "description": "Narrower industries to include, like Payments or Healthcare IT.", "items": { "type": "string", "enum": [ "Agriculture", "Analytics", "Apparel and Cosmetics", "Asset Management", "Automotive", "Aviation and Space", "Banking and Exchange", "Climate", "Construction", "Consumer Electronics", "Consumer Finance", "Consumer Health and Wellness", "Content", "Credit and Lending", "Defense", "Diagnostics", "Drones", "Drug Discovery and Delivery", "Energy", "Engineering, Product and Design", "Finance and Accounting", "Food and Beverage", "Gaming", "Healthcare IT", "Healthcare Services", "Home and Personal", "Housing and Real Estate", "Human Resources", "Industrial Bio", "Infrastructure", "Insurance", "Job and Career Services", "Legal", "Manufacturing and Robotics", "Marketing", "Medical Devices", "Office Management", "Operations", "Payments", "Productivity", "Recruiting and Talent", "Retail", "Sales", "Security", "Social", "Supply Chain and Logistics", "Therapeutics", "Transportation Services", "Travel, Leisure and Tourism", "Virtual and Augmented Reality" ] } }, "regions": { "title": "Regions", "type": "array", "description": "Countries or regions the companies are listed under, like \"United States of America\", \"Europe\", \"India\", \"Remote\" or \"Fully Remote\".", "items": { "type": "string" } }, "statuses": { "title": "Status", "type": "array", "description": "Company status.", "items": { "type": "string", "enum": [ "Active", "Acquired", "Public", "Inactive" ] } }, "tags": { "title": "Tags", "type": "array", "description": "Topic tags as the directory shows them, like \"Artificial Intelligence\", \"SaaS\" or \"Developer Tools\".", "items": { "type": "string" } }, "teamSizeMin": { "title": "Team size from", "minimum": 0, "type": "integer", "description": "Smallest team size." }, "teamSizeMax": { "title": "Team size to", "minimum": 0, "type": "integer", "description": "Largest team size." }, "hiringOnly": { "title": "Hiring now", "type": "boolean", "description": "Only companies with open jobs.", "default": false }, "nonprofitOnly": { "title": "Nonprofits only", "type": "boolean", "description": "Only nonprofit companies.", "default": false }, "topCompaniesOnly": { "title": "Top companies only", "type": "boolean", "description": "Only Y Combinator's top companies.", "default": false }, "startUrls": { "title": "Company or job links", "type": "array", "description": "Y Combinator company links (https://www.ycombinator.com/companies/airbnb), company short names (airbnb) or job links. With filters too, both are scraped.", "items": { "type": "string" } }, "includeDetails": { "title": "Company details", "type": "boolean", "description": "Companies only: also read each company page for its year founded, city, social links, founders, primary partner and number of open jobs. Company links always include details.", "default": false }, "jobRoles": { "title": "Job roles", "type": "array", "description": "Jobs only: roles to keep.", "items": { "type": "string", "enum": [ "Engineering", "Operations", "Sales", "Marketing", "Support", "Product", "Design", "Science", "Recruiting & HR", "Legal", "Finance" ] } }, "jobTypes": { "title": "Job types", "type": "array", "description": "Jobs only: job types to keep.", "items": { "type": "string", "enum": [ "Full-time", "Internship", "Contract" ] } }, "jobLocation": { "title": "Job location contains", "type": "string", "description": "Jobs only: keep jobs whose location contains these words, like \"Remote\", \"San Francisco\" or \"London\"." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Most rows to save in the whole run (0 = no limit).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default works for most runs. If results come back empty, try a different proxy option.", "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 }, "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 } } } } } } } } } }