{ "openapi": "3.0.1", "info": { "title": "YC Companies Scraper", "description": "Y Combinator companies from the public directory, with batch, status, team size, industry, tags, location and hiring flag, about 6,300 in October 2026. Filter by batch, industry, tag, region or team size, or schedule a run that returns only companies added since the last one.", "version": "0.1", "x-build-id": "YdlZD2mIAfvyjSai3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~yc-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-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/deriverge~yc-companies-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-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/deriverge~yc-companies-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-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": { "batches": { "title": "Batches", "type": "array", "description": "YC batches, for example Summer 2025, Winter 2024, or the short codes S25, W24, F25, X25 (Spring). Leave empty for every batch since 2005.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Industry or subindustry names as YC uses them, for example B2B, Consumer, Fintech, Healthcare, Developer Tools, Artificial Intelligence. Partial names match.", "items": { "type": "string" } }, "tags": { "title": "Tags (any of)", "type": "array", "description": "YC tags, for example SaaS, Marketplace, AI, Climate, Robotics. Partial names match.", "items": { "type": "string" } }, "status": { "title": "Status", "type": "array", "description": "Active, Acquired, Public or Inactive. Leave empty for all.", "items": { "type": "string" } }, "regions": { "title": "Regions (any of)", "type": "array", "description": "For example United States of America, Europe, India, Latin America, Remote. Partial names match.", "items": { "type": "string" } }, "locations": { "title": "Locations (any of)", "type": "array", "description": "Matched against the company's location text, for example San Francisco, London, Berlin.", "items": { "type": "string" } }, "hiringOnly": { "title": "Only companies that are hiring", "type": "boolean", "description": "Keep only companies YC marks as hiring.", "default": false }, "topOnly": { "title": "Only top companies", "type": "boolean", "description": "Keep only companies on YC's top companies list.", "default": false }, "minTeamSize": { "title": "Minimum team size", "minimum": 1, "type": "integer", "description": "Drop companies with a smaller or unknown team." }, "maxTeamSize": { "title": "Maximum team size", "minimum": 1, "type": "integer", "description": "Drop companies with a larger team." }, "keywords": { "title": "Keywords (any of)", "type": "array", "description": "Keep only companies whose name, one-liner, description or tags mention at least one of these words, case-insensitive.", "items": { "type": "string" } }, "launchedAfter": { "title": "Launched after", "type": "string", "description": "Keep only companies that launched on YC after this date (YYYY-MM-DD)." }, "includeLongDescription": { "title": "Include the long description", "type": "boolean", "description": "The full company description from the YC directory. Turn it off for a compact table.", "default": true }, "newOnly": { "title": "Return only companies new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only companies that were not there before. Schedule it daily during a batch and you have a new-company alert that bills only for what is new; the CHANGES record also lists status, team size and hiring changes.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"s25-watch\". Runs from a saved task get a snapshot automatically even without a name." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned companies.", "default": 10000 } } }, "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 } } } } } } } } } }