{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Listing Scraper", "description": "Extracts the full Y Combinator companies directory (~6000) directly from the Algolia backend that powers ycombinator.com/companies. Fast, no browser.", "version": "0.1", "x-build-id": "eejmHwncdDLX6eKMj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datacach~y-combinator-companies-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datacach-y-combinator-companies-listing-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/datacach~y-combinator-companies-listing-scraper/runs": { "post": { "operationId": "runs-sync-datacach-y-combinator-companies-listing-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/datacach~y-combinator-companies-listing-scraper/run-sync": { "post": { "operationId": "run-sync-datacach-y-combinator-companies-listing-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": { "query": { "title": "Search query", "type": "string", "description": "Optional full-text search term (company name or keyword), exactly like the search box on the YC site. Leave it empty to return the whole directory (optionally narrowed by the filters below)." }, "batches": { "title": "YC batches", "type": "array", "description": "YC funding batches to include, e.g. \"Summer 2024\". Options are listed newest first. Leave empty to include all batches.", "items": { "type": "string", "enum": [ "Unspecified", "Winter 2027", "Fall 2026", "Summer 2026", "Spring 2026", "Winter 2026", "Fall 2025", "Summer 2025", "Spring 2025", "Winter 2025", "Fall 2024", "Summer 2024", "Winter 2024", "Summer 2023", "Winter 2023", "Summer 2022", "Winter 2022", "Summer 2021", "Winter 2021", "Summer 2020", "Winter 2020", "Summer 2019", "Winter 2019", "Summer 2018", "Winter 2018", "Summer 2017", "Winter 2017", "Summer 2016", "Winter 2016", "Summer 2015", "Winter 2015", "Summer 2014", "Winter 2014", "Summer 2013", "Winter 2013", "Summer 2012", "Winter 2012", "Summer 2011", "Winter 2011", "Summer 2010", "Winter 2010", "Summer 2009", "Winter 2009", "Summer 2008", "Winter 2008", "Summer 2007", "Winter 2007", "Summer 2006", "Winter 2006", "Summer 2005" ] }, "default": [] }, "industries": { "title": "Industries", "type": "array", "description": "Top-level industry categories (the 9 broad sectors YC groups companies into). Leave empty to include all industries. Use \"Subindustries\" below for finer-grained categories.", "items": { "type": "string", "enum": [ "B2B", "Consumer", "Education", "Fintech", "Government", "Healthcare", "Industrials", "Real Estate and Construction", "Unspecified" ] }, "default": [] }, "subindustries": { "title": "Subindustries", "type": "array", "description": "Fine-grained categories nested under the top-level industries (e.g. \"Security\", \"Payments\", \"Healthcare IT\"). Free text — see the README for the full list. Leave empty to include all.", "default": [], "items": { "type": "string" } }, "tags": { "title": "Tags", "type": "array", "description": "Company tags, e.g. \"Artificial Intelligence\", \"SaaS\", \"Developer Tools\". Free text — see the README for the full list. Leave empty to include all.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Geographic regions and remote options (e.g. \"United States of America\", \"Europe\", \"Fully Remote\"). Leave empty to include all regions.", "items": { "type": "string", "enum": [ "Africa", "Algeria", "America / Canada", "Argentina", "Asia", "Australia", "Austria", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Brazil", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Croatia", "Cyprus", "Czechia", "Democratic Republic of the Congo", "Denmark", "East Asia", "Ecuador", "Egypt", "Estonia", "Ethiopia", "Europe", "Finland", "France", "Fully Remote", "Georgia", "Germany", "Ghana", "Greece", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iraq", "Ireland", "Israel", "Italy", "Ivory Coast", "Japan", "Kenya", "Kyrgyzstan", "Latin America", "Latvia", "Lithuania", "Malaysia", "Mexico", "Middle East and North Africa", "Morocco", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nigeria", "Norway", "Oceania", "Pakistan", "Panama", "Partly Remote", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Remote", "Romania", "Russia", "Saudi Arabia", "Senegal", "Seychelles", "Singapore", "Slovenia", "South Africa", "South Asia", "South Korea", "Southeast Asia", "Spain", "Sweden", "Switzerland", "Tanzania", "Thailand", "Turkey", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States of America", "Unspecified", "Uruguay", "Venezuela", "Vietnam", "Zambia" ] }, "default": [] }, "statuses": { "title": "Company status", "type": "array", "description": "Operating status: \"Active\" (still operating), \"Acquired\", \"Public\" (IPO'd), or \"Inactive\" (shut down). Leave empty to include all statuses.", "items": { "type": "string", "enum": [ "Acquired", "Active", "Inactive", "Public" ] }, "default": [] }, "minTeamSize": { "title": "Min team size", "minimum": 0, "type": "integer", "description": "Only return companies with at least this many employees. Mirrors the lower bound of the YC \"Company size\" filter. Leave empty for no minimum." }, "maxTeamSize": { "title": "Max team size", "minimum": 0, "type": "integer", "description": "Only return companies with at most this many employees. Mirrors the upper bound of the YC \"Company size\" filter. Leave empty for no maximum." }, "isHiring": { "title": "Only companies that are hiring", "type": "boolean", "description": "When enabled, returns only companies with open roles on the YC jobs board. When disabled (default), companies are included regardless of hiring status.", "default": false }, "nonprofitOnly": { "title": "Only nonprofits", "type": "boolean", "description": "When enabled, returns only nonprofit companies. When disabled (default), both for-profit and nonprofit companies are included.", "default": false }, "topCompaniesOnly": { "title": "Only top companies", "type": "boolean", "description": "When enabled, returns only companies flagged by YC as a \"top company\". When disabled (default), all companies are included.", "default": false }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of companies to store in the dataset. Set to 0 (default) for no limit — this returns the entire matching selection, up to the full directory of ~6000 companies. Free plan is capped at 10 companies regardless of this value; upgrade to a paid plan to remove the limit.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of parallel requests sent to the Algolia backend. 8-16 is fast and polite; lower it if you hit rate limits.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Not needed for this Actor — the Algolia backend has no anti-bot protection — so you can safely leave it disabled.", "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 } } }, "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 } } } } } } } } } }