{ "openapi": "3.0.1", "info": { "title": "Wellfound (AngelList) Startup Jobs Scraper Comp, Equity & Email", "description": "Wellfound (AngelList) jobs scraper: paste a /role/ search URL or a keyword and get thousands of startup jobs with the FULL description on every row: title, compensation, equity, remote, posted date, emplo. type, experience + company name, size, funding stage, YC/unicorn flags. Dedup, optional emails", "version": "0.0", "x-build-id": "1BlZcZX6CMmxByDD6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~wellfound-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~wellfound-jobs-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~wellfound-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "startUrls": { "title": "Wellfound URLs — /role/… recommended (optional)", "type": "array", "description": "Paste one or more Wellfound URLs. Role searches are the surface to use:\n\n**✅ Role search — volume and real filtering**\n• `https://wellfound.com/role/software-engineer` — every job for a role, **all locations** (about 5,000 for software engineer)\n• `https://wellfound.com/role/r/software-engineer` — the same role, **remote jobs only**\n• `https://wellfound.com/role/l/product-manager/new-york` — role + location\n\nThese paginate for real and are filtered by Wellfound itself, and every row comes back with the **full job description**, structured employment type and years-of-experience — no enrichment needed. A role Wellfound does not publish is detected and skipped (Wellfound would otherwise answer with an unrelated generic job list), and a misspelt role is corrected to the nearest real one where there is a clear match.\n\n**⚠️ Landing page — limited**\n• `https://wellfound.com/jobs` (with or without `?market=` / `?industry=` / `?location=`)\n\nThis is an SEO landing page: it returns the same **~50 curated jobs** whatever filters or `?page=` you give it. Fine for a quick sample, useless for coverage.\n\n**❌ Not start URLs:** a single job (`/jobs/{id}-{slug}`) or a company page (`/company/{slug}`) is not a job listing. For company funding, founders and social links, run a role search with **Enrich company profile** on.\n\nRows are de-duplicated by job ID across the whole run, so overlapping URLs never bill twice.\n\n**Leave empty to search by keyword and location instead.**", "items": { "type": "string" } }, "keyword": { "title": "Keyword(s) — comma-separated for OR logic", "type": "string", "description": "**No start URL?** Then the keyword picks the search itself: a role name such as `product designer` becomes Wellfound's own role search (`/role/product-designer`, all locations, or the remote-only `/role/r/product-designer` when **Remote jobs only** is on), which reaches the full job pool instead of the ~50-job landing page. List several roles with commas (`data analyst, data engineer, data scientist`) and each gets its own search, sharing your `maxItems` between them. A term that is not a Wellfound role but contains a broader one (`performance marketing`, `B2B sales`) searches that broader role (`/role/marketing`, `/role/sales`) and keeps the term as a filter there, so you get the jobs that mention it. Other words that are not a Wellfound role are left out of the search and named in the log. A role with \"intern\" in it (`machine learning intern`) searches that role and keeps internships only. Used this way, the keyword is not re-applied as a text filter, except on those broader-role searches.\n\n**With start URLs**, the keyword is a filter: a case-insensitive whole-word match (a word may carry a common ending, so `engineer` also finds \"engineering\" and `intern` finds \"internship\" but not \"internal\"), across job title, role slug, company name, market tags, location tags, badge labels, and (when enrichment is on) job description. Rows that don't match are filtered out before being written to the dataset.\n\nExamples:\n• `rust` → keeps rows mentioning Rust\n• `rust, golang, scala` → keeps rows mentioning ANY of the three (OR logic)\n• `senior` → keeps senior-level roles\n\n**How well this works depends on your start URL.** On a **`/role/…`** URL the scraper searches thousands of jobs and the full job description is included in the match, so even a narrow keyword has a real corpus to hit. On a **`/jobs`** URL it is filtering a curated set of only ~50 jobs, so a narrow keyword (`Cloud Security GRC Specialist`) will usually match nothing at all — not a failure, just a tiny pool. The run log says so explicitly when it happens.\n\n**Cost behaviour**: filtering happens after fetching, so compute is unchanged — but result charges only fire for rows that pass the filter. You never pay for rows you filter out, and `maxItems` counts kept rows, not fetched ones.\n\nLeave empty to disable filtering." }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs flagged remote. With a keyword and no start URLs this also switches the search to Wellfound's remote-only listing (`/role/r/…`). Applied before charging — you don't pay for filtered-out rows.", "default": false }, "minSalary": { "title": "Minimum salary (USD / year)", "minimum": 0, "type": "integer", "description": "Keep only jobs whose compensation band reaches at least this amount, e.g. 120000. Jobs with no listed compensation are kept (never dropped just for missing pay). Applied before charging." }, "maxSalary": { "title": "Maximum salary (USD / year)", "minimum": 0, "type": "integer", "description": "Keep only jobs whose compensation band starts at or below this amount, e.g. 250000. Jobs with no listed compensation are kept. Applied before charging." }, "jobTitle": { "title": "Job title contains", "type": "string", "description": "Keep only jobs whose title contains this word or phrase (case-insensitive, whole words — intern matches \"Intern\" and \"Internship\" but not \"Internal\"). Narrower than Keyword, which also searches company name, tags and description. Comma-separated for OR: engineer, developer." }, "jobType": { "title": "Employment type", "enum": [ "any", "full-time", "part-time", "contract", "internship" ], "type": "string", "description": "On **`/role/…`** URLs this matches Wellfound's own structured employment-type field, so it is exact. On **`/jobs`** URLs no such field exists, so it falls back to matching the job title/role text.", "default": "any" }, "experience": { "title": "Seniority", "enum": [ "any", "junior", "mid", "senior", "executive" ], "type": "string", "description": "Uses the level the **job title** states: Senior / Lead / Principal / Staff → senior; Head of / Director / VP / Chief / Founder → executive; Junior / Entry-level / Graduate / Intern / Associate → junior. When the title states no level, Wellfound's structured years-of-experience decides where it is given (0–2 years junior, 3–4 mid, 5+ senior). A title with neither counts as mid-level. The job description is not searched for this: words like \"leadership\" or \"director\" appear in almost every posting and would make the filter meaningless.", "default": "any" }, "includeNoSalary": { "title": "Include jobs without salary", "type": "boolean", "description": "Wellfound publishes many roles with no compensation shown. Leave on to keep them; turn off to get only jobs with pay data.", "default": true }, "companyCategories": { "title": "Company categories", "type": "array", "description": "Keep only companies whose market tags, one-liner or business type mention any of these (case-insensitive, whole words; hyphens and spaces are interchangeable). Example: saas, fintech, artificial intelligence.", "items": { "type": "string" } }, "includeCompanies": { "title": "Only these companies", "type": "array", "description": "Allow-list of company names or Wellfound slugs (case-insensitive substring match).", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude these companies", "type": "array", "description": "Block-list of company names or slugs. Takes precedence over the allow-list above.", "items": { "type": "string" } }, "equityMin": { "title": "Minimum equity (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Keep only jobs whose equity range reaches at least this percent (compared with the TOP of the range, e.g. 0.1%–0.5% passes a 0.3 floor). Jobs that list no equity are dropped when this is set. Leave empty for no filter." }, "visaSponsorship": { "title": "Visa sponsorship", "enum": [ "any", "offered", "not_refused" ], "type": "string", "description": "Read from the job description. 'Only jobs that offer sponsorship' keeps postings that say so explicitly; 'Drop jobs that refuse sponsorship' removes postings that explicitly rule it out and keeps the rest. Detection is conservative: postings that say nothing clear are treated as unknown. /role/ search URLs carry full descriptions; /jobs URLs need 'Enrich job detail' for full text.", "default": "any" }, "sort": { "title": "Sort by posted date", "enum": [ "none", "newest", "oldest" ], "type": "string", "description": "Orders the whole run (not just each page) — the actor buffers all rows before writing when sorting is on. Jobs with no posted date are placed last.", "default": "none" }, "market": { "title": "Market filter", "type": "string", "description": "Wellfound market slug. Examples: `ai`, `fintech`, `web3`, `saas`, `cyber-security`, `developer-tools`, `mobile`, `e-commerce`, `consumer`, `b2b`. Used to build `https://wellfound.com/jobs?market={value}` when no `startUrls` is provided. See the section note above — Wellfound currently ignores this filter server-side." }, "industry": { "title": "Industry filter", "type": "string", "description": "Wellfound industry slug. Examples: `real-estate-tech`, `cyber-security`, `blockchain-cryptocurrency`, `health-care`, `education`, `gaming`. Used to build `https://wellfound.com/jobs?industry={value}` when no `startUrls` is provided. Note: `market` and `industry` overlap; pick one." }, "location": { "title": "Location filter", "type": "string", "description": "City or region, e.g. `new-york`, `san-francisco`, `london`, `berlin`, `bangalore`, `europe`, `united-states`. Together with a keyword (and no start URLs) it narrows the role search to that place (`/role/l/product-designer/new-york`). Only locations Wellfound publishes can be applied; anything else would silently return worldwide jobs, so the run log names the supported ones and leaves an unknown value out. `remote` is not a place on Wellfound: it switches on **Remote jobs only**, which is a real filter. Without a keyword, it builds the `/jobs?location=…` landing page (about 50 curated jobs)." }, "maxItems": { "title": "Max jobs per listing URL", "minimum": 1, "type": "integer", "description": "Upper bound on job rows emitted **per startUrl** — a ceiling, not a target. Each row is one paid event, and you are only ever charged for **unique** jobs.\n\nHow much data actually exists depends entirely on the URL you paste:\n• **`/role/…` URLs** — thousands. `/role/r/software-engineer` reports 1,855 matching jobs across 47 pages; the scraper reads the page's own page count and stops exactly at the end. Raise `maxItems` here and you really do get more.\n• **`/jobs` URLs** — roughly **50 unique jobs**, and the same 50 regardless of `?page=` or any filter. Setting `maxItems: 5000` on a `/jobs` URL still returns ~50; the scraper stops as soon as a page yields nothing new rather than billing you for repeats.\n\nDefault 1000. Free-tier users are additionally capped at 100 total rows across the whole run.", "default": 1000 }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel HTTP requests across listing URLs. Wellfound's listing surface is friendly; concurrency 3-5 is the sweet spot. Higher values risk rate-limiting on the residential proxy pool, not on Wellfound's edge.", "default": 4 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Per-URL retry budget. Each retry rotates the proxy session with mild exponential backoff and re-races three HTTP stacks (impit Firefox / gotScraping / impers Chrome142). Default 10 — Wellfound's listing surface is reliable enough that ≤3 retries usually suffice, but the budget is there for proxy hiccups.", "default": 10 }, "enrichCompanyProfile": { "title": "Add company funding + founders + social URLs (extra +$1.50 per 1,000 unique companies enriched)", "type": "boolean", "description": "💰 **Pricing**: $0.0015 per unique company successfully enriched ($1.50 per 1,000 companies), on top of the row charge. De-duplicated: a company with 56 jobs = 1 enrichment charge, not 56. Failed enrichments are NOT charged. Example: 1,000 rows across 150 unique companies ≈ $1.09 for the rows (≈ $1.99 from 30 Sep 2026) + ≈ $0.23 for 150 companies.\n\nEvery job row also includes the company's:\n\n• Total funding raised (e.g. Airbnb: $11.3B)\n• Funding-round history — Series A/B/C, IPO, dates\n• Founders — names, slugs, avatars\n• Social URLs — Twitter, LinkedIn, Facebook, blog, ProductHunt\n• Official company website\n• Operating / incubator / shell flags + Wellfound's profile-completeness score\n\n**How it works:** company pages sit behind a Cloudflare check that plain HTTP clients never pass, so the actor opens one real browser session on a residential IP, lets the check complete, then fetches each company with that session (about 1-2 s per company). It needs a residential proxy — the default. On a datacenter proxy Wellfound asks for an interactive check, so company enrichment is skipped (and not charged).\n\nReliability (September 2026): 12 of 12 companies enriched on each of three proxy routes in testing. Not every company lists funding; websites and LinkedIn are almost always present.", "default": false }, "enrichJobDetail": { "title": "Add full job description (legacy — /jobs URLs only)", "type": "boolean", "description": "⚠️ **You probably don't need this.** Jobs scraped from a **`/role/…`** search already include the **full job description**, structured employment type and years-of-experience, at no extra charge — this toggle skips them and they are never billed for it.\n\nIt only does something for **`/jobs`** landing-page rows, where the listing carries just a snippet: the actor fetches each job's own page for the full description and structured salary. Failed fetches are never charged, and the actor stops trying if most of the first job pages fail.\n\n💰 Pricing when it does fire: $0.0015 per job enriched ($1.50 per 1,000), on top of the row charge.\n\n**Recommended instead:** paste a role URL such as `https://wellfound.com/role/software-engineer` and leave this off.", "default": false }, "enrichEmails": { "title": "Enrich with company contact emails (experimental, billed per email)", "type": "boolean", "description": "If enabled, tries to find a contact email for each company by reading its website's contact/about pages (e.g. info@, careers@). Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort, billed per contact email found; only charged when an email is returned, never for misses.", "default": false }, "incrementalMode": { "title": "♻️ Incremental mode (only new/changed)", "type": "boolean", "description": "Track results across runs and only emit (and charge for) NEW, UPDATED, and REAPPEARED records. First run builds the baseline; schedule the same input daily/hourly and pay only for the diff.", "default": false }, "stateKey": { "title": "🔑 State key", "type": "string", "description": "Stable name for the tracked search universe. Leave empty to derive one automatically from your search inputs. Set it explicitly if you tweak filters but want to keep the same history." }, "emitUnchanged": { "title": "♻️ Also emit unchanged records", "type": "boolean", "description": "In incremental mode, also push records that haven't changed since the last run (each pushed record is charged as a normal result).", "default": false }, "emitExpired": { "title": "⚰️ Emit expired records", "type": "boolean", "description": "In incremental mode, push a small tombstone record when a previously-seen result disappears (charged as a normal result).", "default": false }, "skipReposts": { "title": "🚫 Skip reposts", "type": "boolean", "description": "In incremental mode, skip listings that look like reposts of previously-expired ones (same content under a new ID).", "default": false }, "maxAgeMinutes": { "title": "⏱️ Max age (minutes)", "minimum": 1, "type": "integer", "description": "Only keep jobs posted within this many minutes. Handy for scheduled runs, e.g. 1440 for a daily schedule. Only in-window jobs count toward maxItems, so the actor keeps paging to find them (Wellfound does not list jobs by date), up to a scan limit of 25 pages per URL. Older jobs are skipped and never charged." }, "telegramBotToken": { "title": "🤖 Telegram bot token", "type": "string", "description": "Bot token from @BotFather. Required together with the chat ID for Telegram alerts." }, "telegramChatId": { "title": "💬 Telegram chat ID", "type": "string", "description": "Chat or channel that receives the alerts, e.g. \"-1001234567890\" or \"@mychannel\". The bot must be a member." }, "slackWebhookUrl": { "title": "💼 Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL (api.slack.com/messaging/webhooks)." }, "discordWebhookUrl": { "title": "🎮 Discord webhook URL", "type": "string", "description": "Discord webhook URL (Server Settings → Integrations → Webhooks)." }, "webhookUrl": { "title": "🪝 Generic webhook URL", "type": "string", "description": "Any endpoint (n8n, Make, Zapier, your API) — receives a JSON POST with run metadata, diff counts, and the notable records." }, "webhookHeaders": { "title": "🔑 Webhook headers", "type": "object", "description": "Optional headers sent with the generic webhook POST, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "notificationLimit": { "title": "📊 Max items per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many records to list inside each alert message (1–20). Everything is always in the dataset regardless.", "default": 5 }, "notifyOnlyChanges": { "title": "🔕 Notify only on changes", "type": "boolean", "description": "With incremental mode on, stay silent when a run finds nothing new or updated.", "default": false }, "maxUnblockerRequests": { "title": "Max unblocker requests (DataDome fallback)", "minimum": 0, "type": "integer", "description": "When the free HTTP + browser lanes are blocked by DataDome, the actor falls back to a paid WAF-bypass chain to reliably fetch the page. This caps how many metered requests (scrape.do, scrapingbee) a single run may make, bounding cost. GeoNode leads the chain and is on an unlimited plan, so its pages do NOT count toward this cap. Default 0 — the free lanes have been enough; raise it if a run ends empty with `[FETCH] free lanes exhausted` in the log.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Leave as-is. With the default setting the actor picks the proxy for you: a US residential exit, because Wellfound blocks most datacenter IPs on its search pages (runs on the plain automatic proxy were being blocked about one time in four). On free-plan runs, a proxy group or custom proxy URLs you choose here are used exactly as given. Paid runs always use the actor's own residential pool.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }