{ "openapi": "3.0.1", "info": { "title": "Company Scout", "description": "An Actor that finds YCombinator companies matching your criteria, enriches each with its matching LinkedIn company record, and scrapes LinkedIn job postings for the resulting shortlist.", "version": "0.0", "x-build-id": "rPAbHk9EqSq4uzUwm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tri_angle~company-scout/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tri_angle-company-scout", "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/tri_angle~company-scout/runs": { "post": { "operationId": "runs-sync-tri_angle-company-scout", "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/tri_angle~company-scout/run-sync": { "post": { "operationId": "run-sync-tri_angle-company-scout", "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": { "search_query": { "title": "Search query", "type": "string", "description": "Keyword to search for among YC companies.", "default": "" }, "batch": { "title": "Batch", "type": "array", "description": "Filter by YC batch (e.g. ['W23', 'S22']). Leave empty for all batches.", "items": { "type": "string" }, "default": [] }, "status": { "title": "Status", "type": "array", "description": "Filter by company status (e.g. ['Active', 'Public']). Leave empty for all statuses.", "items": { "type": "string" }, "default": [] }, "industry": { "title": "Industry", "type": "array", "description": "Filter by industry tags (e.g. ['B2B', 'SaaS']). Leave empty for all industries.", "items": { "type": "string" }, "default": [] }, "regions": { "title": "Regions", "type": "array", "description": "Filter by region (e.g. ['US', 'Europe']). Leave empty for all regions.", "items": { "type": "string" }, "default": [] }, "min_team_size": { "title": "Minimum team size", "minimum": 1, "type": "integer", "description": "Only include companies with at least this many employees.", "default": 1 }, "launched_after": { "title": "Launched after", "type": "string", "description": "Only include companies launched after this date (ISO 8601, e.g. '2022-01-01').", "default": "" }, "is_hiring": { "title": "Is hiring", "type": "boolean", "description": "Only include companies that are currently hiring.", "default": true }, "max_items": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of YC companies to fetch.", "default": 100 }, "delta_mode": { "title": "Delta mode", "type": "boolean", "description": "Only fetch companies added or updated since the last run.", "default": false }, "linkedin_jobs_count": { "title": "LinkedIn jobs per company", "minimum": 1, "type": "integer", "description": "Maximum number of LinkedIn job postings to fetch per matched company.", "default": 1000 }, "scrape_company": { "title": "Scrape company details on each job", "type": "boolean", "description": "When enabled, the LinkedIn jobs scraper performs an extra request per job to enrich the record with company details (logo, description, website, employee count, address). Disable to reduce cost and speed up runs.", "default": true }, "filters": { "title": "Filters", "type": "array", "description": "WARN: This feature is disabled for the time being.\nList of JS epressions with `item` in the context (type follows dataset schema). Evaluate to falsy to exclude the evaluated company, truthy to keep it.", "items": { "type": "string" }, "default": [] }, "filter_prompt": { "title": "Filter prompt", "type": "string", "description": "Prompt passed to the LLM when evaluating filters against each company.", "default": "" } } }, "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 } } } } } } } } } }