{ "openapi": "3.0.1", "info": { "title": "Y Combinator Scraper", "description": "Extract Y Combinator companies, founders, open jobs, and Launch YC posts from the public YC directory. Native filters or a pasted directory URL, no browser, CRM-ready output.", "version": "1.0", "x-build-id": "Vw6fsdJEIUjFczRD1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabri.ce~y-combinator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabri.ce-y-combinator-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/fabri.ce~y-combinator-scraper/runs": { "post": { "operationId": "runs-sync-fabri.ce-y-combinator-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/fabri.ce~y-combinator-scraper/run-sync": { "post": { "operationId": "run-sync-fabri.ce-y-combinator-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", "required": [ "searchMode" ], "properties": { "searchMode": { "title": "How do you want to pick companies?", "enum": [ "filters", "url" ], "type": "string", "description": "Pick one. **Use filters** builds the search from the fields below. **Paste a directory link** reuses the filters from a URL you copied from the YC directory. Whichever one you don't pick is ignored." }, "directoryUrl": { "title": "Directory link", "type": "string", "description": "Only used if you picked \"Paste a directory link\" above. Open https://www.ycombinator.com/companies, choose your filters there, then copy the whole link from your browser's address bar and paste it here. Industry pages like https://www.ycombinator.com/companies/industry/artificial-intelligence also work." }, "batches": { "title": "Batches", "type": "array", "description": "One or more YC batches, written exactly like the site shows them: \"Summer 2026\", \"Winter 2025\", \"Spring 2025\". Leave empty to include every batch.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Keep only companies in these industries, e.g. \"B2B\", \"Consumer\", \"Healthcare\", \"Fintech\", \"Education\".", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Keep only companies operating in these regions, e.g. \"United States of America\", \"Europe\", \"India\", \"Latin America\".", "items": { "type": "string" } }, "tags": { "title": "Tags", "type": "array", "description": "Keep only companies with these topic tags, e.g. \"Artificial Intelligence\", \"Developer Tools\", \"Climate\", \"Fintech\".", "items": { "type": "string" } }, "query": { "title": "Keyword", "type": "string", "description": "Optional. Only keep companies whose name or description mentions this word or phrase." }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "Keep only companies with at least one open role." }, "topCompany": { "title": "Only YC \"top companies\"", "type": "boolean", "description": "Keep only companies YC marks as top companies." }, "nonprofit": { "title": "Only nonprofits", "type": "boolean", "description": "Keep only nonprofit organizations." }, "maxItems": { "title": "Maximum companies", "minimum": 1, "type": "integer", "description": "Stop after this many companies. Leave empty to get all of them. Note: the Apify Free plan is always limited to 10." }, "outputMode": { "title": "How should rows be organized?", "enum": [ "company", "founder" ], "type": "string", "description": "**One row per company** puts founders and jobs inside each company row. **One row per founder** repeats the company details on every founder, so the file is ready to import straight into a CRM as contacts." }, "scrapeFounders": { "title": "Include founders and full company details", "type": "boolean", "description": "Opens each company's YC page to add founders, YC partner, exact location, year founded, all social links, photos, and videos. Turn this off (and the options below) for the quickest run with only the basics." }, "scrapeJobs": { "title": "Include open jobs", "type": "boolean", "description": "Add every open role for each company: title, location, remote, salary, equity, required experience, visa, skills, the full job description, and the hiring manager." }, "scrapeLaunches": { "title": "Include Launch YC posts", "type": "boolean", "description": "Add the company's Launch YC announcements, including the full post text." }, "scrapeNews": { "title": "Include news mentions", "type": "boolean", "description": "Add the press mentions listed on the company's YC page (title, link, date)." }, "concurrency": { "title": "How many company pages to load at once", "minimum": 1, "maximum": 50, "type": "integer", "description": "Higher is faster but more likely to be rate-limited by YC. Lower it if you see \"didn't respond\" warnings." } } }, "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 } } } } } } } } } }