{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Scraper: YC Startups, Founders & Jobs", "description": "All 6,300 Y Combinator companies with founders (LinkedIn, bio, email), year founded, socials, news and open jobs. Built to beat Y Combinator Scraper (michael.g): same founders and jobs on a 25-company test, plus news, at $2 vs $12.50 per 1,000 with founders. From $1 per 1,000.", "version": "0.1", "x-build-id": "9iMxJAwqTM0PW6PeB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidyharvest~yc-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidyharvest-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/tidyharvest~yc-companies-scraper/runs": { "post": { "operationId": "runs-sync-tidyharvest-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/tidyharvest~yc-companies-scraper/run-sync": { "post": { "operationId": "run-sync-tidyharvest-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": "What to return", "enum": [ "companies", "founders", "jobs" ], "type": "string", "description": "Companies: one row per YC company. Founders: one row per founder with the company attached. Jobs: one row per open job at YC companies (Work at a Startup).", "default": "companies" }, "query": { "title": "Search", "type": "string", "description": "Free-text search, the same as the search box on ycombinator.com/companies (e.g. AI agents, payroll, robotics). Empty = no text filter." }, "batches": { "title": "YC batches", "type": "array", "description": "Batch codes or names: W24, S25, P25 (Spring), F25 (Fall), Winter 2024, or a year (2025 = every 2025 batch). Empty = all batches.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Top-level or sub-industry as YC labels it (B2B, Fintech, Healthcare, Engineering, Product and Design...). Any of them matches.", "items": { "type": "string", "enum": [ "Agriculture", "Analytics", "Apparel and Cosmetics", "Asset Management", "Automotive", "Aviation and Space", "B2B", "Banking and Exchange", "Climate", "Construction", "Consumer", "Consumer Electronics", "Consumer Finance", "Consumer Health and Wellness", "Content", "Credit and Lending", "Defense", "Diagnostics", "Drones", "Drug Discovery and Delivery", "Education", "Energy", "Engineering, Product and Design", "Finance and Accounting", "Fintech", "Food and Beverage", "Gaming", "Government", "Healthcare", "Healthcare IT", "Healthcare Services", "Home and Personal", "Housing and Real Estate", "Human Resources", "Industrial Bio", "Industrials", "Infrastructure", "Insurance", "Job and Career Services", "Legal", "Manufacturing and Robotics", "Marketing", "Medical Devices", "Office Management", "Operations", "Payments", "Productivity", "Real Estate and Construction", "Recruiting and Talent", "Retail", "Sales", "Security", "Social", "Supply Chain and Logistics", "Therapeutics", "Transportation Services", "Travel, Leisure and Tourism", "Unspecified", "Virtual and Augmented Reality" ] } }, "tags": { "title": "Tags", "type": "array", "description": "YC tags such as Artificial Intelligence, AI, Generative AI, SaaS, Developer Tools, Robotics. Any of them matches. Examples: B2B, SaaS, Artificial Intelligence, AI, Fintech, Developer Tools, Marketplace, Generative AI, Consumer, Machine Learning, E-commerce, Healthcare, Analytics, Hardware, Health Tech", "items": { "type": "string" } }, "regions": { "title": "Regions / countries", "type": "array", "description": "YC's HQ regions: United States of America, India, United Kingdom, Europe, Latin America, Remote... Any of them matches.", "items": { "type": "string" } }, "locations": { "title": "Location contains", "type": "array", "description": "Keep companies whose location text contains any of these (e.g. San Francisco, London, Bangalore).", "items": { "type": "string" } }, "status": { "title": "Status", "type": "array", "description": "Empty = every status.", "items": { "type": "string", "enum": [ "Active", "Inactive", "Acquired", "Public" ] } }, "stages": { "title": "Stage", "type": "array", "description": "Empty = every stage.", "items": { "type": "string", "enum": [ "Early", "Growth" ] } }, "isHiring": { "title": "Hiring now only", "type": "boolean", "description": "Only companies with open jobs on Work at a Startup." }, "topCompany": { "title": "YC Top Companies only", "type": "boolean", "description": "Only companies YC lists as Top Companies." }, "nonprofit": { "title": "Nonprofits only", "type": "boolean", "description": "Only nonprofits." }, "teamSizeMin": { "title": "Team size from", "minimum": 0, "type": "integer", "description": "Smallest team size to keep (YC's employee count)." }, "teamSizeMax": { "title": "Team size up to", "minimum": 0, "type": "integer", "description": "Largest team size to keep." }, "companies": { "title": "Specific companies", "type": "array", "description": "YC company slugs or profile URLs (airbnb, https://www.ycombinator.com/companies/stripe). Combined with the search above only if you also set filters.", "items": { "type": "string" } }, "startUrls": { "title": "YC URLs", "type": "array", "description": "Any ycombinator.com URL: a filtered directory link (companies?batch=Winter%202025&industry=Fintech), a company profile, a job board page (/jobs/role/software-engineer/san-francisco) or a job link.", "items": { "type": "string" } }, "includeDetails": { "title": "Founders, news, jobs and socials", "type": "boolean", "description": "Read each company's YC profile: founders (name, title, bio, LinkedIn, X), year founded, LinkedIn/X/Facebook/Crunchbase/GitHub links, news headlines, open jobs, launches, YC partner. Off = directory fields only (cheaper and faster). Always on in founders and jobs mode.", "default": true }, "findEmails": { "title": "Find emails", "type": "boolean", "description": "Read each company's own website for published emails and phones, and give each founder an email: the address the site publishes for them, else one built from the site's naming pattern, else first-name@domain (labelled as a guess; turn guesses off below). Charged per company with at least one email.", "default": false }, "emailGuesses": { "title": "Include pattern-based founder emails", "type": "boolean", "description": "Off = only addresses the website itself publishes.", "default": true }, "jobRoles": { "title": "Job roles", "type": "array", "description": "eng, design, product, sales, marketing, operations, recruiting, support, science (or YC's slugs such as software-engineer). Empty = all.", "items": { "type": "string" } }, "jobTypes": { "title": "Job types", "type": "array", "description": "Empty = all.", "items": { "type": "string", "enum": [ "Full-time", "Part-time", "Internship", "Contract", "Co-founder" ] } }, "jobLocations": { "title": "Job location contains", "type": "array", "description": "e.g. San Francisco, New York, India, remote.", "items": { "type": "string" } }, "jobKeywords": { "title": "Job title or skill contains", "type": "array", "description": "Keep jobs whose title, specialty or skills contain any of these (e.g. machine learning, React, founding).", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only jobs open to remote work." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Only jobs posted in the last N days. Empty = any date." }, "includeJobDescriptions": { "title": "Full job descriptions", "type": "boolean", "description": "Adds the full description, exact posting date, salary min/max, interview process and hiring manager for each job.", "default": true }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "For scheduled runs: return (and charge) only companies, founders or jobs this monitor has not returned before." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate 'only new' memories for different schedules." }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Hard cap on rows for the whole run (also caps your cost). 0 or empty = no limit (the full directory is about 6,300 companies)." } } }, "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 } } } } } } } } } }