{ "openapi": "3.0.1", "info": { "title": "Wellfound Jobs Scraper - Startup Roles, Salaries & Remote Jobs", "description": "Scrape startup jobs from Wellfound.com by keyword, location, role, or remote status. Extract job details, compensation, company badges, and other listing data, with MCP connector export support.", "version": "0.1", "x-build-id": "3MuO5pz4YkZqlPBtx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-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/abotapi~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-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/abotapi~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-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", "required": [ "mode" ], "properties": { "mode": { "title": "Input mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode builds Wellfound location pages from the locations field. URL mode reads the pasted Wellfound URLs.", "default": "search" }, "locations": { "title": "Locations", "type": "array", "description": "Wellfound location slugs or names. Examples: san-francisco, new-york, london. Each location is searched separately.", "items": { "type": "string" } }, "startUrls": { "title": "Wellfound URLs", "type": "array", "description": "Paste Wellfound URLs: /location/, /jobs, /role/, /role/l//, /role/r/, or a single job page /jobs/-. www.wellfound.com and angel.co links are accepted. Company pages (/company/...) are not supported. Listing pagination starts at the page in the URL; a job page returns that one job.", "default": [ { "url": "https://wellfound.com/location/san-francisco" }, { "url": "https://wellfound.com/jobs" }, { "url": "https://wellfound.com/role/python-developer" }, { "url": "https://wellfound.com/role/l/software-engineer/san-francisco" }, { "url": "https://wellfound.com/role/r/software-engineer" }, { "url": "https://wellfound.com/jobs/4839998-senior-software-engineer-ruby-rails-mvr" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Keywords", "type": "array", "description": "Only keep jobs where at least one keyword appears in the title, company, role, location, badges, compensation, or description text.", "items": { "type": "string" } }, "roleKeywords": { "title": "Role keywords", "type": "array", "description": "Only keep jobs whose title or primary role contains at least one of these values. Examples: engineer, product, sales.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Only keep jobs marked as remote or with remote configuration data.", "default": false }, "requireCompensation": { "title": "Require compensation", "type": "boolean", "description": "Only keep jobs with a compensation value.", "default": false }, "activelyHiringOnly": { "title": "Actively hiring only", "type": "boolean", "description": "Only keep jobs attached to companies marked as actively hiring in the listing data.", "default": false }, "jobTypes": { "title": "Job types", "type": "array", "description": "Only keep jobs of these types: full-time, part-time, contract, internship. Leave empty for all.", "items": { "type": "string" } }, "experienceLevel": { "title": "Experience level", "enum": [ "any", "entry", "mid", "senior" ], "type": "string", "description": "Entry = up to 1 year required, mid = 2 to 5 years, senior = 6+ years (from the years of experience Wellfound lists).", "default": "any" }, "includeNoExperience": { "title": "Keep jobs with no experience listed", "type": "boolean", "description": "Only used with an experience level. When on, jobs that list no years of experience are kept.", "default": true }, "minSalary": { "title": "Minimum salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose listed pay reaches at least this amount (as listed, in the job's own currency and period). 0 = off.", "default": 0 }, "maxSalary": { "title": "Maximum salary", "minimum": 0, "type": "integer", "description": "Keep jobs whose listed pay starts at or below this amount. 0 = off.", "default": 0 }, "includeNoSalary": { "title": "Keep jobs with no salary listed", "type": "boolean", "description": "Only used with a minimum or maximum salary. When on, jobs without a listed salary are kept.", "default": true }, "postedWithinDays": { "title": "Posted within days", "minimum": 0, "type": "integer", "description": "Only keep jobs posted in the last N days. 0 = off.", "default": 0 }, "includeCompanies": { "title": "Include companies", "type": "array", "description": "Only keep jobs from these companies (Wellfound company slug or exact name).", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Drop jobs from these companies (Wellfound company slug or exact name).", "items": { "type": "string" } }, "companySize": { "title": "Company size", "type": "array", "description": "Only keep jobs from companies in these size bands, e.g. 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001+.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "default", "newest", "oldest" ], "type": "string", "description": "Wellfound has no sort parameter, so newest/oldest sorts client-side by posted date over the matched jobs collected up to Max items (not the whole site). Default keeps the site order.", "default": "default" }, "includeJobDetails": { "title": "Include job details", "type": "boolean", "description": "Open each saved job's page for extra fields: benefits, visa sponsorship, relocation, application link, salary period, equity range, experience level, remote policy, company website and industries. Adds one request per saved row; rows still bill once.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of matching job rows to save. The run can return fewer rows when the selected location, URL, keyword, and filters match fewer current jobs.", "default": 20 }, "maxPages": { "title": "Max pages per source", "minimum": 0, "type": "integer", "description": "Maximum Wellfound pages to read per location or pasted URL. Leave empty to walk every result page; max items is the primary output cap.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Uses Apify Proxy residential by default. Leave as-is unless your account or run environment requires another route.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID (or dataset ID) from this actor to continue a large job pull without returning or charging for jobs already collected there (matched by jobId). Use this after an interrupted run. For recurring daily monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching jobs as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED jobs. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those jobs returned (and billed). State is kept separately for each search/URL and filter setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the mode/locations/URLs/keywords/filters: different searches then never mix state with each other." }, "emitUnchanged": { "title": "Emit unchanged jobs (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return jobs that have not changed since the last run, marked UNCHANGED. This returns (and bills) extra rows you already have, so leave it off unless you specifically want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired jobs (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return jobs that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search, not when Max items capped it or when Resume was used. This returns (and bills) extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore these fields when detecting changes (incremental mode only)", "type": "array", "description": "Field names that must NOT make a job count as UPDATED, for example noisy counters. Top-level names (e.g. applicantCount) or nested paths (parent.child, parent.*). The fields are still returned in every row; they are only left out of the comparison. Scraped time and source page URL are always ignored. Changing this list does not re-flag your saved jobs.", "items": { "type": "string" }, "default": [] }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped jobs into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify > Settings > API & Integrations, then select it here. Notion gets a page-per-job export; other connectors receive a best-effort write or digest. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page", "type": "string", "description": "URL or id of the Notion page under which job pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max jobs to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on how many jobs are written to each selected connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }