{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper: Startup Jobs, Salary, Equity & Stage", "description": "Wellfound startup jobs with salary and equity as numbers, plus company stage, size and badges (YC, top investors) on every row. Role, location, salary, equity, stage and size filters, full descriptions, new-jobs-only monitoring. No proxy, no login.", "version": "0.1", "x-build-id": "7yJb4CbVVcUxDJsp9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasmithlab~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasmithlab-wellfound-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/datasmithlab~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-datasmithlab-wellfound-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/datasmithlab~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-datasmithlab-wellfound-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": "Wellfound role names as they appear in the address: software-engineer, product-manager, designer, data-scientist, marketing-manager, sales... One search per role and location.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "City or region as in Wellfound addresses (san-francisco, new-york, london, berlin, bangalore, united-states...) or 'remote' for remote jobs. Leave empty for all locations.", "items": { "type": "string" } }, "startUrls": { "title": "Wellfound search URLs", "type": "array", "description": "Optional. Paste search pages such as https://wellfound.com/role/l/data-scientist/london. Only wellfound.com/role/... pages are supported.", "items": { "type": "string" } }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Each page holds about 40 jobs. A broad role can have 90 pages; narrow searches have fewer.", "default": 5 }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep jobs where any keyword appears as a whole word in the title, role, company, one-liner or description. Jobs that don't match are not charged.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude words in title", "type": "array", "description": "Drop jobs whose title contains any of these words (whole-word match).", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only jobs Wellfound marks as remote.", "default": false }, "jobTypes": { "title": "Job type", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "internship" ] } }, "minSalary": { "title": "Minimum yearly salary", "minimum": 1, "type": "integer", "description": "Top of the salary range, converted to yearly (monthly x12, hourly x2080). Jobs without a salary, or with an unclear period, are dropped. Amounts are never converted between currencies: it applies to the Salary currency below (USD if you leave that empty)." }, "salaryCurrency": { "title": "Salary currency", "enum": [ "USD", "EUR", "GBP", "INR", "CAD", "AUD", "SGD", "MXN", "AED", "CHF", "SEK", "PLN", "BRL", "ILS" ], "type": "string", "description": "Only jobs paying in this currency (jobs without a salary are dropped)." }, "minEquityPercent": { "title": "Minimum equity (%)", "minimum": 0, "type": "number", "description": "Top of the equity range must be at least this, e.g. 0.5." }, "maxYearsExperience": { "title": "Max years of experience required", "minimum": 0, "type": "integer", "description": "Keep jobs asking for at most this many years (0 = new grads and internships). Jobs that state no requirement are kept." }, "postedWithin": { "title": "Posted within", "enum": [ "any", "24h", "3d", "7d", "14d", "30d" ], "type": "string", "description": "Only jobs published in this window.", "default": "any" }, "companySizes": { "title": "Company size", "type": "array", "description": "Number of employees.", "items": { "type": "string", "enum": [ "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001+" ] } }, "companyStages": { "title": "Company stage", "type": "array", "description": "Early, growth, scale or public stage, as Wellfound labels them.", "items": { "type": "string", "enum": [ "early_stage", "growth_stage", "scale_stage", "public_stage" ], "enumTitles": [ "Early Stage", "Growth Stage", "Scale Stage", "Public Stage" ] } }, "ycBackedOnly": { "title": "Y Combinator backed only", "type": "boolean", "description": "Only companies with Wellfound's YC badge.", "default": false }, "topInvestorsOnly": { "title": "Top investors only", "type": "boolean", "description": "Only companies with Wellfound's Top Investors badge.", "default": false }, "activelyHiringOnly": { "title": "Actively hiring only", "type": "boolean", "description": "Only companies with the Actively Hiring badge.", "default": false }, "includeCompanies": { "title": "Only these companies", "type": "array", "description": "Company names or Wellfound slugs, e.g. chalk-ai.", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Company names or Wellfound slugs to skip.", "items": { "type": "string" } }, "includeDescription": { "title": "Include descriptions", "type": "boolean", "description": "Full job description as Markdown and plain text. Same price either way.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new jobs since last run", "type": "boolean", "description": "Return only jobs not seen in a previous run with the same filters. Schedule it daily for job alerts.", "default": false }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard stop: you are never charged for more jobs than this.", "default": 100 } } }, "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 } } } } } } } } } }