{ "openapi": "3.0.1", "info": { "title": "Y Combinator Jobs with Pay Bands, Equity and Visa Terms", "description": "Every open job at Y Combinator companies, read company by company, with pay parsed into currency and period. The YC jobs pages ignore their own filters and cap at 50 with no total, so a landing page is a sample. Filter by batch, industry, region or role, or name the companies.", "version": "0.1", "x-build-id": "0Oklz0gisf1mbIM0k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gubidonius~yc-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gubidonius-yc-jobs", "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/gubidonius~yc-jobs/runs": { "post": { "operationId": "runs-sync-gubidonius-yc-jobs", "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/gubidonius~yc-jobs/run-sync": { "post": { "operationId": "run-sync-gubidonius-yc-jobs", "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": { "companySlugs": { "title": "Company slugs", "type": "array", "description": "Read the jobs of these companies and no others, by the slug at the end of their Y Combinator URL, for example airbnb or razorpay. When this is filled the directory search below is skipped entirely.", "default": [], "items": { "type": "string" } }, "batches": { "title": "Batches", "type": "array", "description": "Batch names exactly as Y Combinator writes them, for example Summer 2026. Not S26: a value the directory does not use returns zero companies, so every value is checked against the live list first and the run tells you the real spelling.", "default": [ "Summer 2026" ], "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Top-level industries of the hiring company, for example B2B, Fintech, Healthcare.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Regions as YC groups the company, for example United States of America, Europe, South Asia. This is the company's region, not the job's location.", "default": [], "items": { "type": "string" } }, "tags": { "title": "Tags", "type": "array", "description": "Product tags on the company, for example Artificial Intelligence or Developer Tools.", "default": [], "items": { "type": "string" } }, "statuses": { "title": "Company statuses", "type": "array", "description": "One or more of Active, Inactive, Acquired, Public. Leave empty for all four.", "default": [], "items": { "type": "string" } }, "query": { "title": "Free-text company search", "type": "string", "description": "Words to search for in company names, taglines and descriptions. It searches companies, not job titles.", "default": "" }, "roleGroups": { "title": "Role families", "type": "array", "description": "Keep only these role families, for example Engineering, Design, Sales, Marketing, Operations. YC's own short codes such as eng also work. Filtered-out jobs are counted in the run summary and are never charged.", "default": [], "items": { "type": "string" } }, "onlyCompaniesMarkedHiring": { "title": "Only search companies marked as hiring", "type": "boolean", "description": "Restrict the company search to the 1,478 companies whose directory record says they are hiring. Measured on 6 September 2026: none of 40 companies without the flag had a posting, and 4 of 60 with it had nothing posted, so the flag saves a lot of requests and is not proof of an open role.", "default": true }, "maxCompanies": { "title": "Maximum companies to read", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many company job pages the run may open. One page is one request and yields about three and a half jobs, so this is the work budget.", "default": 25 }, "maxResults": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on jobs for the WHOLE run. You are never charged for more than this.", "default": 100 }, "openEachJobPage": { "title": "Open each job's own page", "type": "boolean", "description": "Open each job's own page for the full advert text, the interview process and the HIRING MANAGER'S NAME. The company jobs page carries no hiring manager at all, on 205 postings sampled, and the job page carried one on 25 of 25. It is one extra request per job and is charged as its own event, so leave it off unless you want those three fields.", "default": 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 } } } } } } } } } }