{ "openapi": "3.0.1", "info": { "title": "YC Jobs Scraper", "description": "Open jobs at Y Combinator startups from Work at a Startup, with salary and equity as numbers, visa terms, required experience and the company's batch and team size. Filter by role, location, visa sponsorship or batch, or schedule it to return only new jobs.", "version": "0.1", "x-build-id": "maBtU05VZAvuIeL1m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~yc-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-yc-jobs-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-jobs-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-yc-jobs-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-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-yc-jobs-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": { "roles": { "title": "Roles", "type": "array", "description": "Keep only these job families. Leave empty for all.", "items": { "type": "string", "enum": [ "eng", "design", "product", "sales", "marketing", "operations", "support", "science", "finance", "recruiting", "legal" ], "enumTitles": [ "Engineering", "Design", "Product", "Sales", "Marketing", "Operations", "Support", "Science", "Finance", "Recruiting & HR", "Legal" ] } }, "jobTypes": { "title": "Job types", "type": "array", "description": "Keep only these types. Leave empty for all.", "items": { "type": "string", "enum": [ "Full-time", "Internship", "Contract", "Co-founder" ], "enumTitles": [ "Full-time", "Internship", "Contract", "Co-founder" ] } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs whose location includes Remote.", "default": false }, "locations": { "title": "Locations (any of)", "type": "array", "description": "Keep only jobs whose location mentions one of these, for example \"San Francisco\", \"New York\", \"London\" or \"US\".", "items": { "type": "string" } }, "visaSponsorship": { "title": "Visa sponsorship only", "type": "boolean", "description": "Keep only jobs where the company says it will sponsor a visa.", "default": false }, "minSalary": { "title": "Minimum salary (USD per year)", "type": "integer", "description": "Keep only jobs whose published top of range reaches this amount. Salaries in other currencies are compared at approximate rates; jobs without a published salary are dropped." }, "maxYearsRequired": { "title": "Maximum years of experience required", "minimum": 0, "type": "integer", "description": "Keep only jobs that ask for at most this many years. Use 0 for jobs open to new graduates." }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 1, "type": "integer", "description": "Keep only jobs posted recently. YC shows the age as text (about 1 month), so this is approximate." }, "keywords": { "title": "Keywords (any of)", "type": "array", "description": "Keep only jobs whose title, skills, company name or one-liner contain one of these, for example \"python\", \"founding\" or \"AI\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, skills, company name or one-liner contain any of these.", "items": { "type": "string" } }, "batches": { "title": "YC batches", "type": "array", "description": "Only companies from these batches, as S25, W26 or Summer 2025. Leave empty for all.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Only companies in these industries or tags, for example Fintech, B2B, Healthcare or Developer Tools.", "items": { "type": "string" } }, "companies": { "title": "Companies", "type": "array", "description": "Only these companies, as YC slugs (stripe) or company page links. Leave empty for every hiring YC company.", "items": { "type": "string" } }, "includeDescription": { "title": "Include the full job description", "type": "boolean", "description": "Opens each matching job to add its full description and interview process. Slower; the price is the same.", "default": false }, "newOnly": { "title": "Return only jobs new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only jobs that were not there before. Schedule it daily for a job alert.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot used by the new-only mode, for example \"yc-engineering\". Runs from a saved task get one automatically." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned jobs. The run stops reading companies as soon as it has this many.", "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 } } } } } } } } } }