{ "openapi": "3.0.1", "info": { "title": "Y Combinator Companies Scraper - YC Startup Directory, Founders", "description": "Export Y Combinator companies from the YC startup directory: filter by batch, industry, region, status, team size and hiring. Get websites, domains, descriptions and team size, plus optional founders and social profiles for VC research, deal sourcing and CRM enrichment.", "version": "0.1", "x-build-id": "hKd6NEW7ioFSjCqVq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~ycombinator-companies/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-ycombinator-companies", "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/s-r~ycombinator-companies/runs": { "post": { "operationId": "runs-sync-s-r-ycombinator-companies", "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/s-r~ycombinator-companies/run-sync": { "post": { "operationId": "run-sync-s-r-ycombinator-companies", "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": "Query", "maxLength": 500, "type": "string", "description": "Search company names, taglines and descriptions. Default: empty (all companies)." }, "batches": { "title": "Batches", "type": "array", "description": "YC batches, for example Summer 2025 or S25. OR within this list.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Exact YC industry values, such as B2B or Fintech. OR within the list.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Exact YC regions, such as Europe, America / Canada or Remote.", "items": { "type": "string" } }, "statuses": { "title": "Statuses", "type": "array", "description": "YC company statuses. OR within the list.", "items": { "type": "string" } }, "is_hiring": { "title": "Is hiring", "type": "boolean", "description": "When true, return companies marked as hiring. False leaves this filter disabled." }, "top_company": { "title": "Top company", "type": "boolean", "description": "When true, return YC top companies. False leaves this filter disabled." }, "nonprofit": { "title": "Nonprofit", "type": "boolean", "description": "When true, return nonprofit companies. False leaves this filter disabled." }, "team_size_min": { "title": "Team size min", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Minimum published headcount, inclusive." }, "team_size_max": { "title": "Team size max", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Maximum published headcount, inclusive." }, "sort": { "title": "Sort", "enum": [ "relevance", "launch_date" ], "type": "string", "description": "YC relevance or most recently published directory profiles. Partitioned relevance exports use stable batch groups.", "default": "relevance" }, "max_results": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum delivered companies over all cursor pages. Default: 100 for search, all unique company_slugs for profile lookup. If maxResults is also present, the lower limit applies." }, "include_details": { "title": "Include details", "type": "boolean", "description": "Read public founder profiles, company socials, founding year and job count. Default: false.", "default": false }, "company_slugs": { "title": "Company slugs", "type": "array", "description": "YC slugs or company profile URLs; duplicates are removed. Uses detail mode and ignores search filters. Without max_results or maxResults, all unique profiles are requested.", "items": { "type": "string" } }, "cursor": { "title": "Cursor", "maxLength": 2000000, "type": "string", "description": "Opaque continuation returned as next_cursor. Keep the other inputs identical." }, "maxResults": { "title": "Maxresults", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Alias of max_results. When both are supplied, the lower limit applies." }, "isHiring": { "title": "Ishiring", "type": "boolean", "description": "Alias of is_hiring. Conflicting values are invalid." }, "topCompany": { "title": "Topcompany", "type": "boolean", "description": "Alias of top_company. Conflicting values are invalid." }, "tags": { "title": "Tags", "type": "array", "description": "Exact YC tags, such as AI.", "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 } } } } } } } } } }