SOCIAL MEDIA

Wellfound Browse Jobs API

Browse public Wellfound job listings through the anonymous SEO GraphQL search: job id, slug, title, compensation, equity, locations, full description and the hiring company, with deep pagination. No login. Takes a blob from wellfound-public-session and must run on the exit that minted it. Company funding fields are empty on anonymous results; use wellfound-company-overview for those.

wellfoundjobssearchpublic

Try it free Get an API key

How to call it

Send one POST to api.upapi.io/wellfound-browse-jobs.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 6 weighted units of your monthly quota. The operation times out after 60 seconds. Responses are not cached; every call runs the operation.

endpoint

POST https://api.upapi.io/wellfound-browse-jobs.post

Wellfound Browse Jobs API reference

Request parameters

page: integer — 1-based page number.
scope: string — Use remote for the remote search, otherwise a Wellfound location slug.
session: stringrequired — Blob from wellfound-public-session.
proxyUrl: string — Same exit the session was minted on. Omit to send directly.
roleSlug: stringrequired — Role slug to search, for example software-engineer.

Response fields

jobs: array
jobs[].id: stringrequired
jobs[].slug: string
jobs[].title: string
jobs[].equity: string
jobs[].jobUrl: string — Canonical listing page, https://wellfound.com/jobs/<id>-<slug>. Empty when Wellfound disclosed no slug, because both halves are required: the id alone 404s.
jobs[].remote: boolean — True or False as Wellfound disclosed it. Null means Wellfound did not say -- it is NOT inferred from the scope you searched.
jobs[].jobType: string
jobs[].startupId: string
jobs[].description: string — Full listing description; the SEO search returns it inline.
jobs[].liveStartAt: integer
jobs[].startupName: string
jobs[].startupSlug: string
jobs[].compensation: string
jobs[].locationNames: array
jobs[].startupLogoUrl: string
jobs[].remoteConfigKind: string — REMOTE, ONSITE or ONSITE_OR_REMOTE. Empty when undisclosed.
jobs[].startupCompanySize: string
jobs[].startupHighConcept: string
jobs[].startupTotalRaised: string — Empty on anonymous results; use wellfound-company-overview.
jobs[].startupFundingStage: string — Empty on anonymous results; use wellfound-company-overview.
session: string — Refreshed blob carrying rotated cookies. Persist THIS one, not the input.
elapsedMs: integer
hasNextPage: boolean — False when Wellfound sent no page count, so a paginating caller stops.
totalJobCount: integer

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "page": 1,
  "scope": "remote",
  "session": "example",
  "roleSlug": "software-engineer"
}

json — example response shape

{
  "jobs": [
    {
      "id": "example",
      "slug": "",
      "title": "",
      "equity": "",
      "jobUrl": "",
      "remote": false,
      "jobType": "",
      "startupId": "",
      "description": "",
      "liveStartAt": 1,
      "startupName": "",
      "startupSlug": "",
      "compensation": "",
      "locationNames": [
        "example"
      ],
      "startupLogoUrl": "",
      "remoteConfigKind": "",
      "startupCompanySize": "",
      "startupHighConcept": "",
      "startupTotalRaised": "",
      "startupFundingStage": ""
    }
  ],
  "session": "",
  "elapsedMs": 0,
  "hasNextPage": false,
  "totalJobCount": 0
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/wellfound-browse-jobs.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "page": 1, "scope": "remote", "session": "example", "roleSlug": "software-engineer" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/wellfound-browse-jobs.post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "page": 1,
  "scope": "remote",
  "session": "example",
  "roleSlug": "software-engineer"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/wellfound-browse-jobs.post',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "page": 1,
  "scope": "remote",
  "session": "example",
  "roleSlug": "software-engineer"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "page": 1, "scope": "remote", "session": "example", "roleSlug": "software-engineer" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/wellfound-browse-jobs.post", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'page' => 1,
    'scope' => 'remote',
    'session' => 'example',
    'roleSlug' => 'software-engineer',
]);

$ch = curl_init('https://api.upapi.io/wellfound-browse-jobs.post');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/wellfound-browse-jobs.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "page": 1, "scope": "remote", "session": "example", "roleSlug": "software-engineer" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"page\": 1, \"scope\": \"remote\", \"session\": \"example\", \"roleSlug\": \"software-engineer\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/wellfound-browse-jobs.post")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"page\": 1, \"scope\": \"remote\", \"session\": \"example\", \"roleSlug\": \"software-engineer\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/wellfound-browse-jobs.post", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Wellfound Browse Jobs API cost per call?

Each call spends 6 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Wellfound Browse Jobs API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Wellfound Browse Jobs API responses cached?

No — every call runs the operation live; responses are not cached.

More Social Media APIs

Wellfound Job Detail Wellfound Public Session Wellfound Search Jobs Wellfound Company Overview Wellfound List Applications Wellfound Pipeline Stats Wellfound Refresh Operations Wellfound Application Modal

Browse every Social Media API →