{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Scraper - YC Startup Directory", "description": "Search the Y Combinator startup directory by batch (W24, S23), industry, region, tag, status or stage. Each company row has the pitch, batch, status, team size, founded year, location, website, tags and founders with LinkedIn and X links. $0.90 per 1,000 companies.", "version": "0.1", "x-build-id": "bum3zWbG0nIBhfgQL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~ycombinator-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-ycombinator-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/dami_studio~ycombinator-companies-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-ycombinator-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/dami_studio~ycombinator-companies-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-ycombinator-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": { "batches": { "title": "Batches", "minItems": 0, "maxItems": 60, "type": "array", "description": "YC batches to pull, written either short (W24, S23, F24, P25) or long (Winter 2024, Summer 2023). Leave empty to search across every batch. Each batch is queried separately, so ten batches and 100 rows gives you ten companies from each.", "items": { "type": "string" } }, "industries": { "title": "Industries", "minItems": 0, "maxItems": 60, "type": "array", "description": "Filter by the industry labels the directory itself uses, for example B2B, Consumer, Healthcare, Fintech, Industrials, Education, Infrastructure, Marketing, Security, Climate. Several values are combined with OR.", "items": { "type": "string" } }, "regions": { "title": "Regions", "minItems": 0, "maxItems": 60, "type": "array", "description": "Filter by the region labels the directory uses, for example United States of America, Europe, India, Latin America, Remote, Canada, Africa, Southeast Asia. Several values are combined with OR.", "items": { "type": "string" } }, "tags": { "title": "Tags", "minItems": 0, "maxItems": 60, "type": "array", "description": "Filter by the free-form tags on a company profile, for example Artificial Intelligence, SaaS, Developer Tools, Marketplace, Generative AI, Open Source, Health Tech. Several values are combined with OR.", "items": { "type": "string" } }, "statuses": { "title": "Company status", "minItems": 0, "maxItems": 4, "type": "array", "description": "Keep only companies with these statuses. Leave empty for all four.", "items": { "type": "string", "enum": [ "Active", "Acquired", "Public", "Inactive" ] } }, "stages": { "title": "Company stage", "minItems": 0, "maxItems": 2, "type": "array", "description": "Keep only companies at these stages, as the directory labels them. Leave empty for both. The directory's search can't filter on stage, so the run reads its results and keeps the companies that match; the others are never charged and their profile pages aren't read. A stage filter can return fewer companies than you asked for: with one set, a run reads at most ten times Maximum companies from the directory, never fewer than 1,000 and never more than 10,000. It applies to searches, not to companies you name in Company profile URLs.", "items": { "type": "string", "enum": [ "Early", "Growth" ] } }, "searchTerms": { "title": "Search terms", "minItems": 0, "maxItems": 60, "type": "array", "description": "Free-text search across company names, pitches and descriptions, for example \"robotics\", \"climate\", \"payments in Africa\". Each term is searched separately and can be combined with the filters above.", "items": { "type": "string" } }, "companyUrls": { "title": "Company profile URLs", "minItems": 0, "maxItems": 500, "type": "array", "description": "Look up specific companies instead of searching. Paste full profile URLs (https://www.ycombinator.com/companies/doordash) or bare slugs (doordash). Up to 500 per run.", "items": { "type": "string" } }, "allCompanies": { "title": "Whole directory", "type": "boolean", "description": "Sweep the entire directory instead of filtering. Combine it with a high row limit; the run walks batch by batch, newest first. Remember you pay per company." }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "Keep only companies flagged as hiring on their directory card." }, "topCompaniesOnly": { "title": "Only top companies", "type": "boolean", "description": "Keep only the companies the directory marks as top companies." }, "nonprofitOnly": { "title": "Only non-profits", "type": "boolean", "description": "Keep only the non-profit organisations in the directory." }, "includeFounders": { "title": "Include founders and founded year", "type": "boolean", "description": "On by default. Reads each company's own profile page as well, which is what fills in founder names and titles, the year the company was founded, its city and country, and its LinkedIn, X, Facebook, Crunchbase and GitHub links. Turn it off for a faster, lighter run when you only need the directory card. The price per company is the same either way." }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 7000, "type": "integer", "description": "Total number of companies to return in this run, shared evenly across your batches and search terms. Default 20, hard ceiling 7,000 (the directory holds about 6,200). Keep it low while you are testing - you pay per company." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty for a normal run. Fill it in only if you want the traffic to leave through proxy servers you already pay for, one URL per line, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }