🚀 Wellfound Jobs Scraper

Extract real‑time job listings from Wellfound (formerly AngelList Talent) at scale — straight into a structured Apify dataset.

Search by location, company, keyword, or paste bulk Wellfound URLs. Each job is enriched with title, company, salary range, employment type, posting date, location, and the full job description.

---

🌟 Why Choose This Actor?

✅	What you get
🛡️	Smart anti-bot fallback — starts with no proxy, automatically escalates to Datacenter → Residential when Wellfound's protections kick in
💾	Live dataset writes — each job is pushed the moment it's parsed, so a long run never loses progress
🌍	70+ country geo-targeting for residential proxy sessions
🧭	Two ways to search — bulk URLs or friendly filters (location / keyword / company)
🎛️	Filters out the noise — by date posted, job type, or company match
📝	Full job descriptions — opens each detail page and grabs the complete description
📊	Beautiful Console table — overview and full-detail views, ready to export

---

⚡ Key Features

• 🔗 Bulk URL input via startUrls — paste up to thousands of Wellfound URLs
• 📍 Search-by-filter when you don't have URLs: locationName, companyName, includeKeyword
• 📄 Multi-page pagination with automatic lazy-scroll handling
• 📅 Date filter: today / past 3 days / past week / past month / all
• 💼 Job-type filter: Full-time / Part-time / Contract / Internship / any
• 🌐 UTM-tagged URLs ready for click attribution
• 🛡️ Tiered proxy fallback with sticky residential sessions
• 💳 Pay-per-event monetization — you pay only for results that actually land in your dataset

---

📥 Input

All fields are optional individually, but you must provide at least one of: startUrls, locationName, companyName, or includeKeyword.

{
  "startUrls": [
    { "url": "https://wellfound.com/jobs?location=new-york" }
  ],
  "countryName": "United States",
  "locationName": "New York",
  "companyName": "",
  "includeKeyword": "python engineer",
  "pagesToFetch": 5,
  "jobType": "FULLTIME",
  "datePosted": "week",
  "fetchDescriptions": true,
  "requestDelay": 1.0,
  "proxyConfiguration": { "useApifyProxy": false }
}

Field reference

Field	Type	Description
startUrls	array	Bulk Wellfound URLs (search pages or job-detail pages).
countryName	string	ISO 3166-1 country name (dropdown in the console) for residential proxy geo-targeting.
locationName	string	City/region built into the search URL (e.g. San Francisco).
companyName	string	Filters cards by company name (loose match).
includeKeyword	string	Extra search term — role, skill, technology, etc.
pagesToFetch	integer	Result pages to walk per seed URL (1–100).
jobType	enum	FULLTIME, PARTTIME, CONTRACTOR, INTERN, or empty.
datePosted	enum	today, 3days, week, month, all.
fetchDescriptions	boolean	Open each detail page for the full description (slower, richer).
requestDelay	number	Seconds (float). Random jitter is layered in code.
proxyConfiguration	object	Apify proxy config. Default = no proxy; auto-escalates on block.

---

📤 Output

Each dataset row has this shape:

{
  "job_title": "Founding Product Manager",
  "company_name": "Sardine",
  "location": "San Francisco",
  "posted_via": "Wellfound",
  "salary": "150K–185K a year",
  "job_type": "Contract",
  "date": "today",
  "URL": "https://wellfound.com/jobs/4235686-founding-product-manager?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
  "description": "We are starting an office in San Francisco …"
}

Field	Description
job_title	The role title as shown on the card.
company_name	Hiring company.
location	Comma-joined locations, or "Remote" for remote roles.
posted_via	Always Wellfound.
salary	Normalized range, e.g. 150K–185K a year.
job_type	Full-time, Part-time, Contract, Internship, or empty.
date	Relative posting date (e.g. today, yesterday, 3 days ago).
URL	Direct link to the job with UTM tracking appended.
description	Full description (when fetchDescriptions=true).

The dataset ships with two ready-made views:

• 📋 Overview — title, company, salary, job type, date, location, link
• 📝 Full Details — adds the description column

---

🚀 How to Use (Apify Console)

1. Sign in at console.apify.com → Actors.
2. Open Wellfound Jobs Scraper.
3. Configure your input:
   • Paste URLs in startUrls, or fill in Location / Keyword / Company.
   • Optionally set pagesToFetch, jobType, datePosted.
   • Leave Proxy on the default — the actor escalates automatically only if needed.
4. Click ▶ Start.
5. Watch the live log — each job appears in real time:

   ✅ [12] Founding Product Manager @ Sardine | 150K–185K a year | San Francisco
   

6. Open the Output tab when the run finishes — switch between the Overview and Full Details views.
7. Export to JSON / CSV / Excel with one click.

---

🤖 Use via API

Start a run with curl (replace <ACTOR_ID> and $APIFY_TOKEN):

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "locationName": "New York",
       "pagesToFetch": 3,
       "datePosted": "week"
     }'

Or kick off an async run and poll for status:

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/runs?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"startUrls":[{"url":"https://wellfound.com/jobs?location=san-francisco"}]}'

---

💡 Best Use Cases

• 📊 Job-market intel — track hiring velocity by city, role, or company
• 🧲 Sourcing & lead-gen — build candidate or recruiter contact lists
• 📈 Salary benchmarking — collect comp ranges across companies
• 🧪 Competitor monitoring — see who's hiring for what at which stage
• 🤖 Train AI agents — feed structured, fresh job text to LLMs

---

💰 Pricing

This actor uses Apify's Pay-per-event (PPE) model:

Event	What you pay for
row_result	Each job record successfully written to the dataset

You're billed only for jobs that actually land in your output — blocked pages, retries, and skipped duplicates are on us.

Set your Max charge $ limit in the run options to control your spend precisely. When you hit the cap, the actor exits gracefully with a partial dataset — never a failed run.

---

❓ Frequently Asked Questions

Q: Do I need to configure a proxy? No. The actor starts with a direct connection. Only if Wellfound's anti-bot protection rejects a request does it escalate — first to a datacenter proxy, then to a residential session. You'll see the escalation logged.

Q: Why are some description fields empty? You either turned off fetchDescriptions or the detail page was blocked during that specific request. Re-running with fetchDescriptions=true and the default proxy settings usually fills these in.

Q: Can I scrape a single job by URL? Yes. Put the detail URL (e.g. https://wellfound.com/jobs/4235686-founding-product-manager) into startUrls and the actor will fetch it directly.

Q: How current is the data? It's pulled live every run. Wellfound's date field uses relative phrasing ("today", "3 days ago") — we preserve that exact text in the date column.

Q: Does this scrape private/authenticated content? No. Only publicly available job postings are collected.

---

📜 Cautions / Legal

• Data is collected only from publicly visible Wellfound pages.
• The end user is responsible for compliance with GDPR, CCPA, CAN-SPAM, and Wellfound's Terms of Service.
• Honor reasonable rate limits — the default requestDelay of 1s is intentionally polite.

---

🛟 Support and Feedback

Issues, ideas, or feature requests? Open an issue or contact us via the Apify Console. We respond fast and ship fixes regularly.