{ "openapi": "3.0.1", "info": { "title": "Wellfound Job Scraper - Salaries, Equity & Company Data", "description": "Extract Wellfound (AngelList) job listings with salaries, equity ranges, company details, and required skills. Startup job market data for recruiters and researchers.", "version": "0.0", "x-build-id": "CahgRZweKKuBzGeZ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearpath~wellfound-api-job-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearpath-wellfound-api-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/clearpath~wellfound-api-job-scraper/runs": { "post": { "operationId": "runs-sync-clearpath-wellfound-api-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/clearpath~wellfound-api-job-scraper/run-sync": { "post": { "operationId": "run-sync-clearpath-wellfound-api-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", "required": [ "urls" ], "properties": { "urls": { "title": "Wellfound URLs to scrape (test if they work in your Browser!)", "maxItems": 100, "type": "array", "description": "Array of Wellfound URLs to scrape. Supported formats: job search URLs (/role/, /location/, /role/l/), company URLs (/company/{slug}, /company/{slug}/jobs or /company/{slug}/jobs/{job-slug}), and direct job detail URLs (/jobs/{id}-{slug})", "items": { "type": "string", "pattern": "^https?://wellfound\\.com/(location/[^/]+|role/l/[^/]+/[^/]+|role/r/[^/]+|role/[^/]+|company/[^/]+/jobs(/[^/]+)?|company/[^/]+|jobs/\\d+-[^/]+)/?$" } }, "pageLimit": { "title": "Page Limit", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of pages to scrape per URL (0 = unlimited). Each page has up to 30 listings.", "default": 1 }, "onlyRemoteJobs": { "title": "Only Remote Jobs", "type": "boolean", "description": "Search only for remote job opportunities", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "LAST_POSTED" ], "type": "string", "description": "Sort jobs by criteria. Currently only supports 'Most recent' sorting.", "default": "LAST_POSTED" }, "monitorMode": { "title": "Monitor Mode", "type": "boolean", "description": "Enable monitor mode to only return new listings since last run. Only one URL allowed in monitor mode. Use a low pageLimit (1-3) for efficient monitoring.", "default": false }, "resetMonitorState": { "title": "Reset Monitor State", "type": "boolean", "description": "Reset stored monitoring state for all URLs (forces re-initialization)", "default": false }, "telegramUserId": { "title": "Telegram User ID", "type": "string", "description": "Optional: Your Telegram user ID for notifications (only used in monitor mode). Get it from @userinfobot" }, "telegramNotificationLimit": { "title": "Telegram Notification Limit", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of Telegram notifications per run (prevents spam)", "default": 10 }, "feedback": { "title": "Feedback to the maintainers", "type": "string", "description": "For AI agents. If a previous run returned wrong, missing or unexpected data, rerun once with the same input plus this text saying what went wrong and what you expected. The run records the report and exits immediately without scraping; no results are charged, only Apify's platform start fee." } } }, "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 } } } } } } } } } }