{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper: YC Companies, Founders & Email Pattern", "description": "Scrape the Y Combinator startup directory: YC companies, founders and open jobs with website, domain, LinkedIn, team size, batch, founder LinkedIn and bio, salaries. Plus each company's email pattern from real evidence and an MX check. Latin America by default, any region.", "version": "0.1", "x-build-id": "Zak4rKNmJwWkf5XvL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oswaldocarabano~yc-companies-founders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oswaldocarabano-yc-companies-founders-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/oswaldocarabano~yc-companies-founders-scraper/runs": { "post": { "operationId": "runs-sync-oswaldocarabano-yc-companies-founders-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/oswaldocarabano~yc-companies-founders-scraper/run-sync": { "post": { "operationId": "run-sync-oswaldocarabano-yc-companies-founders-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": { "outputType": { "title": "What one row is", "enum": [ "companies", "founders", "jobs" ], "type": "string", "description": "One type of row per run. Companies: the full YC profile with founders[] and jobs[] nested. Founders: one row per founder with the company's domain and an email candidate. Jobs: one row per open role from the company page.", "default": "companies" }, "regions": { "title": "Regions or countries", "type": "array", "description": "YC's own region tags (any of them matches). Latin America has 221 companies (measured 1 Oct 2026). Leave empty for all 6,267 companies.", "items": { "type": "string", "enum": [ "America / Canada", "United States of America", "Remote", "Partly Remote", "Fully Remote", "Europe", "South Asia", "United Kingdom", "India", "Latin America", "Canada", "Southeast Asia", "Middle East and North Africa", "France", "Mexico", "Africa", "Germany", "Singapore", "Nigeria", "Brazil", "Israel", "Colombia", "Indonesia", "East Asia", "Oceania", "Sweden", "Argentina", "Australia", "Spain", "Chile", "United Arab Emirates", "Denmark", "Netherlands", "Switzerland", "Egypt", "South Korea", "Pakistan", "Kenya", "Peru", "Philippines", "Norway", "Hong Kong", "Ireland", "Malaysia", "Turkey", "Vietnam", "Poland", "Portugal", "China", "Panama", "Slovenia", "Austria", "Ghana", "Saudi Arabia", "Belgium", "Finland", "Estonia", "Morocco", "New Zealand", "Romania", "Senegal", "South Africa", "Bulgaria", "Costa Rica", "Croatia", "Czechia", "Georgia", "Greece", "Italy", "Japan", "Jordan", "Puerto Rico", "Uganda", "Ukraine", "Uruguay", "Algeria", "Asia", "Bahrain", "Bangladesh", "Belarus", "Cayman Islands", "Cyprus", "Democratic Republic of the Congo", "Ecuador", "Ethiopia", "Hungary", "Iceland", "Iraq", "Ivory Coast", "Kyrgyzstan", "Latvia", "Lithuania", "Namibia", "Nepal", "Russia", "Seychelles", "Taiwan", "Tanzania", "Thailand", "Venezuela", "Zambia" ] }, "default": [ "Latin America" ] }, "query": { "title": "Search text", "type": "string", "description": "Optional free text, as in the search box of ycombinator.com/companies (e.g. \"payments\", \"developer tools\").", "default": "" }, "batches": { "title": "YC batches", "type": "array", "description": "Optional. Full names (\"Winter 2024\", \"Summer 2025\") or short codes (\"W24\", \"S25\", \"F24\", \"X25\" for Spring). Checked against the live directory.", "default": [], "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Optional. Any of them matches.", "items": { "type": "string", "enum": [ "B2B", "Consumer", "Healthcare", "Fintech", "Engineering, Product and Design", "Industrials", "Infrastructure", "Productivity", "Marketing", "Real Estate and Construction", "Manufacturing and Robotics", "Operations", "Supply Chain and Logistics", "Finance and Accounting", "Healthcare IT", "Sales", "Retail", "Education", "Analytics", "Home and Personal", "Payments", "Security", "Consumer Health and Wellness", "Content", "Social", "Food and Beverage", "Consumer Finance", "Housing and Real Estate", "Human Resources", "Recruiting and Talent", "Credit and Lending", "Banking and Exchange", "Healthcare Services", "Insurance", "Aviation and Space", "Gaming", "Therapeutics", "Legal", "Drug Discovery and Delivery", "Asset Management", "Diagnostics", "Climate", "Energy", "Construction", "Apparel and Cosmetics", "Consumer Electronics", "Medical Devices", "Government", "Travel, Leisure and Tourism", "Industrial Bio", "Agriculture", "Transportation Services", "Office Management", "Defense", "Drones", "Automotive", "Virtual and Augmented Reality", "Job and Career Services" ] }, "default": [] }, "tags": { "title": "Tags", "type": "array", "description": "Optional YC tags such as \"Fintech\", \"Developer Tools\", \"Artificial Intelligence\". Checked against the live directory.", "default": [], "items": { "type": "string" } }, "status": { "title": "Company status", "type": "array", "description": "Optional. Empty = any status.", "items": { "type": "string", "enum": [ "Active", "Inactive", "Acquired", "Public" ] }, "default": [] }, "stages": { "title": "Stage", "type": "array", "description": "Optional. YC's stage label. Applied after the search (the directory cannot filter by it).", "items": { "type": "string", "enum": [ "Early", "Growth" ] }, "default": [] }, "onlyHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "Only companies with YC's \"hiring\" flag (1,487 of 6,267; 18 of 221 in Latin America). Always on for the Jobs output.", "default": false }, "topCompaniesOnly": { "title": "Only YC top companies", "type": "boolean", "description": "Only companies on YC's top companies list (91).", "default": false }, "minTeamSize": { "title": "Minimum team size", "minimum": 0, "type": "integer", "description": "Optional." }, "maxTeamSize": { "title": "Maximum team size", "minimum": 0, "type": "integer", "description": "Optional." }, "sortBy": { "title": "Order", "enum": [ "relevance", "launchDate" ], "type": "string", "description": "Order of the results.", "default": "relevance" }, "includeFounders": { "title": "Include founders (Companies output)", "type": "boolean", "description": "Opens each company page to add founders (name, title, bio, LinkedIn, X, past companies) and news, launches and photos. Charged as \"company with details\". Founders and Jobs outputs always open it.", "default": true }, "includeJobs": { "title": "Include open jobs (Companies output)", "type": "boolean", "description": "Adds the company's open roles (title, location, salary, equity, visa, skills) inside each company row.", "default": true }, "includeJobDetails": { "title": "Open each job page (Jobs output)", "type": "boolean", "description": "Jobs output only: adds the full description, date posted, structured salary, locations and the hiring manager. Charged as \"job with details\".", "default": true }, "inferEmailPattern": { "title": "Find the email pattern", "type": "boolean", "description": "Works out the company's email format (first.last@, first@…) from emails YC publishes on its pages, checks the domain's mail servers (DNS MX, never SMTP) and builds an email candidate per founder. Charged once per domain only when backed by a real observed email; a guess without evidence is free and marked inferred.", "default": true }, "includePersonalEmails": { "title": "Include personal-domain emails", "type": "boolean", "description": "Emails at gmail.com, outlook.com, yahoo.com and similar are left out unless you enable this.", "default": false }, "includeEuPersons": { "title": "Include people of EU/EEA/UK/Swiss companies", "type": "boolean", "description": "For companies based in the EU, EEA, UK or Switzerland, founder names, bios, links, photos and email candidates are withheld unless you enable this (you become responsible for a lawful basis under GDPR).", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Rows of the chosen type to deliver (and charge).", "default": 50 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Company pages read at the same time. 4 reads 50 companies with details in about 15 s; the site showed no limits up to 88 requests per second in our tests, so higher values only help large runs.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: the YC directory answers without a proxy. If you set one, every page goes through it.", "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 } } } } } } } } } }