Wellfound API: Search jobs

Returns startup job postings for role, location, or both — at least one is required. Slugs are lowercase-hyphenated, exactly as in a wellfound.com URL (software-engineer, san-francisco). remote is valid only on a role-only search; combined with location it is rejected.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

role?string

Wellfound role slug, as it appears in a /role/ URL. At least one of role or location is required.

Length1 <= length

location?string

Wellfound location slug, as it appears in a /location/ URL. At least one of role or location is required.

Length1 <= length

remote?boolean

Restrict to remote postings. Only valid on a role-only search — Wellfound has no remote variant of the location or role+location pages, so combining remote with location is rejected rather than silently ignored.

Defaultfalse

count?integer

How many job rows to return (1-500). A larger count is slower. Fewer may come back when Wellfound's results end; ended_at_source_limit says so.

Range1 <= value <= 500

Default40

curl -X GET "https://example.com/v1/wellfound/jobs/search" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "jobs": [      {        "id": "3061448",        "title": "Senior Software Engineer",        "slug": "senior-software-engineer",        "description": "string",        "compensation": "$110k – $155k",        "jobType": "full-time",        "remote": true,        "remoteConfig": null,        "locationNames": [          "San Francisco",          "New York City"        ],        "acceptedRemoteLocationNames": [          "string"        ],        "primaryRoleTitle": "Software Engineer",        "yearsExperienceMin": 3,        "yearsExperienceMax": 7,        "liveStartAt": 1755216000,        "atsSource": "AtsIntegration::Greenhouse::Listing",        "startup": {          "name": "Anthropic",          "id": "1234567",          "slug": "anthropic",          "logoUrl": "string",          "highConcept": "AI safety and research company",          "companySize": "SIZE_51_200",          "badges": [            null          ],          "property1": null,          "property2": null        },        "property1": null,        "property2": null      }    ],    "startups": [      {        "name": "Anthropic",        "id": "1234567",        "slug": "anthropic",        "logoUrl": "string",        "highConcept": "AI safety and research company",        "companySize": "SIZE_51_200",        "badges": [          null        ],        "property1": null,        "property2": null      }    ],    "count": 40,    "has_more": true,    "ended_at_source_limit": false,    "stop_reason": "count_reached"  }}