{ "openapi": "3.0.1", "info": { "title": "Wellfound AI Job Scraper", "description": "Extract Wellfound startup jobs with pay, equity, locations and company info. Enable optional AI: skills, seniority, summaries, grit scores & match ranking via Candidate Profile. Filter by remote, salary and keywords. Uses public listings—no Wellfound login required for search.", "version": "1.0", "x-build-id": "1rcktFnk8YR5WfwQM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marklp~wellfound-ai-job-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marklp-wellfound-ai-job-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/marklp~wellfound-ai-job-scraper/runs": { "post": { "operationId": "runs-sync-marklp-wellfound-ai-job-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/marklp~wellfound-ai-job-scraper/run-sync": { "post": { "operationId": "run-sync-marklp-wellfound-ai-job-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": { "aiAnalysis": { "title": "Enable AI Analysis", "type": "boolean", "description": "If enabled, each job gets AI-generated fields:\n• one_line_pitch – ultra-short cheat sheet\n• ai_summary – 2-3 sentence description\n• ai_skills – technologies mentioned\n• ai_culture_tags – work-environment labels\n• ai_seniority – inferred level\n• technical_grit – 0-100 ownership score\n• stability – 0-100 company stability score\n• ai_authenticity – how AI-focused the company product is\n• red_flags – warnings (empty if none)", "default": true }, "candidateProfile": { "title": "Candidate Profile (for AI match scoring)", "type": "string", "description": "Optional. Your background in plain text. When set and AI Analysis is enabled, each job also gets:\n• ai_match_score (0-100)\n• ai_match_reasons (why it fits)\n• ai_gaps (requirements you don't meet)\n\nExample: '8 yrs Python/FastAPI, some React, AWS certified. Targeting remote-first roles paying $160k+, ideally AI infra or developer tools.'", "default": "" }, "jobTitle": { "title": "Job Title / Role", "type": "string", "description": "The job role to search for. Use Wellfound's URL slug format or plain text – slugified automatically.\n\nExamples: 'software-engineer', 'product-manager', 'data-scientist'.\n\nProvide at least one of Job Title or Job Location." }, "keywords": { "title": "Keyword Filter", "type": "array", "description": "Only keep jobs whose title contains at least one of these keywords (case-insensitive). Example: ['python', 'react', 'backend']. Leave empty to keep all.", "default": [], "items": { "type": "string" } }, "jobLocation": { "title": "Job Location", "type": "string", "description": "City, region, or country to filter by.\n\nExamples: 'new-york', 'san-francisco', 'united-states', 'london'. Leave blank to search globally.\n\nProvide at least one of Job Title or Job Location.", "default": "" }, "maxItems": { "title": "Maximum Number of Jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job listings to output (after all filters are applied).", "default": 100 }, "maxPages": { "title": "Maximum Pages to Scrape", "minimum": 1, "maximum": 200, "type": "integer", "description": "Limit how many search-result pages to fetch. Each page returns ~40–50 jobs. Set to 1 for a quick test.", "default": 50 }, "fullyRemote": { "title": "Remote Jobs Only", "type": "boolean", "description": "If enabled, only return jobs with a remote work policy. Jobs marked 'In office' or 'Hybrid' are excluded.", "default": false }, "jobType": { "title": "Job Type", "enum": [ "all", "full-time", "part-time", "contract", "internship" ], "type": "string", "description": "Filter by employment type. 'all' returns every type.", "default": "all" }, "lastXDays": { "title": "Posted Within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only include jobs posted within the last N days. Set to 0 to disable the date filter.", "default": 0 }, "minSalary": { "title": "Minimum Salary (USD/year)", "minimum": 0, "type": "integer", "description": "Only include jobs where the listed minimum salary is at or above this value. Set to 0 to disable.", "default": 0 }, "maxSalary": { "title": "Maximum Salary (USD/year)", "minimum": 0, "type": "integer", "description": "Only include jobs where the listed maximum salary is at or below this value. Set to 0 to disable.", "default": 0 }, "includeNoSalary": { "title": "Include Jobs Without Salary", "type": "boolean", "description": "When salary filters are active, also keep jobs that have no salary listed. Disable to show only jobs with explicit salary data.", "default": true }, "includeCompany": { "title": "Include Companies (whitelist)", "type": "array", "description": "Only return jobs from these companies. Use the company slug as it appears in the Wellfound URL (e.g. 'openai', 'stripe'). Leave empty to include all companies.", "default": [], "items": { "type": "string" } }, "excludeCompany": { "title": "Exclude Companies (blacklist)", "type": "array", "description": "Skip jobs from these companies. Use the company slug as it appears in the Wellfound URL (e.g. 'openai', 'stripe').", "default": [], "items": { "type": "string" } } } }, "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 } } } } } } } } } }