Black Falcon Data

Posted on Aug 21 Edited on Aug 24

Wellfound API data export: all 71 fields, grouped

#webscraping #api

The Wellfound API produces 71 fields per record. Here is the complete field list, organized by group, including what each group contains and which values can come back empty.

Below is what our own Wellfound Actor returns, what it costs, and where its coverage ends.

Every field

Every row contains 71 fields, divided into these groups:

company — companyId, companySlug, companyName, companyLogo, companyTagline, companySize, companyDescription, companyFoundedYear, companyLinkedIn, companyTwitter, companyFundingStage, companyTotalRaised, +4 more
salary — salaryMin, salaryMax, salaryEquityMin, salaryEquityMax, salaryCurrency, salaryPeriod
job — jobType, jobBenefits, jobAddressLocality, jobAddressRegion, jobAddressCountry
description — description, descriptionHtml, descriptionMarkdown
extracted — extractedEmails, extractedPhones, extractedUrls
remote — remote, remoteKind
years — yearsExperienceMin, yearsExperienceMax
repost — repostOfId, repostDetectedAt

Here is a real record from one run, trimmed to the leading fields:

{
 "id": "4579450",
 "title": "Software Engineer",
 "slug": "software-engineer",
 "portalUrl": "https://wellfound.com/jobs/4579450-software-engineer",
 "detailUrl": "https://wellfound.com/jobs/4579450-software-engineer",
 "compensation": "$110k - $155k",
 "salaryMin": 110000,
 "salaryMax": 155000,
 "salaryEquityMin": null,
 "salaryEquityMax": null,
 "description": "Join us in pioneering the next generation of nuclear reactors! You'll leverage your sof...",
 "descriptionHtml": null,
 "descriptionMarkdown": "Join us in pioneering the next generation of nuclear reactors! You'll leverage your sof...",
 "jobType": "full-time"
}

Filters that narrow a run

The input accepts 55 options, including query, roles, searchUrls, location, excludeLocations, remote, originLocation, radiusMiles, radiusKm, jobType, experienceLevel, salaryMin, salaryMax, equityMin, visaSponsorship, includeKeywords, excludeKeywords, fromDate, toDate, maxAgeMinutes, and more.

These filters run server-side. You pay for the records you requested instead of producing a larger set and filtering it afterwards.

What it costs

Pricing is per event, with no subscription:

$0.005 per actor start
$0.003 per result

Here are the results of a measured run, not an estimate:

120 records in 91.0 seconds
cost: $0.00876 — about $0.07 per 1,000 records

What people use it for

Benchmarking. Pricing and salary fields support comparisons across the full set instead of requiring someone to eyeball a page of results.
Lead lists. Company-level fields help narrow the data to the relevant segment before anyone opens a CRM.
Change detection. Timestamps make it possible to diff runs and act on new records instead of re-reading the entire set.
Geographic analysis. Location fields allow market-by-market comparisons without a separate data source.

Limits

An empty value means the source showed nothing. Fields are never inferred or completed with information from elsewhere.
The schema follows Wellfound's markup. A redesign can add, rename or drop fields.
Anything Wellfound puts behind a login is absent from every field below, by design.

Questions people ask

Are all fields always populated?

No, and missing values are not guessed. When the source leaves a field blank, it comes back blank. An empty value means Wellfound did not show one, not that extraction failed.

Which markets does it cover?

The location option narrows the run before any records are produced. You pay for the requested market instead of filtering the results afterwards.

Which filters are applied at the source?

jobType, salaryMin, salaryMax, equityMin run server-side. That affects cost as well as convenience: filtered-out records are never produced, so they are never billed.

How fresh is the data?

Every run reads Wellfound when it runs, with no cached copy in between. Two runs a week apart produce two snapshots, enabling change detection.

Can I fetch only what changed?

Yes. incrementalMode exists for that. Without it, a re-run returns the full set again, leaving you to dedupe it on your side.

Is there an official Wellfound export?

No. There is no public bulk export or API. The field list above therefore comes from parsing pages, not from a documented schema.

Try it

If these are the fields you need, the Wellfound API on Apify produces them. New accounts receive $5 of free platform credit each month, enough to cover a real run of this size several times over.

Disclosure: we build and maintain this Actor, and the link above is an affiliate link.

DEV Community