# Wellfound — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover startup jobs, company profiles, and trending opportunities on Wellfound by role and location, with detailed job information and autocomplete suggestions to streamline your job search. Access comprehensive company data and stay updated on what's trending in the startup ecosystem.

**Category:** Jobs | **Website:** [wellfound.com/](https://wellfound.com/) | **Docs:** [parse.bot/marketplace/d395faef-b30f-4ec9-83cf-17873f0371c0/wellfound-com-api](https://parse.bot/marketplace/d395faef-b30f-4ec9-83cf-17873f0371c0/wellfound-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get company jobs

List all open job positions at a specific company. Returns job listings with title, compensation, location, and job type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug (e.g., 'mixpanel', 'juniper-square') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-company-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>"}'
```

### Get company profile

Retrieve a company profile by slug, including description, size, badges, and basic info. Returns stale_input if the company is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_slug` | string | Yes | Company slug (e.g., 'mixpanel', 'juniper-square') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-company-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_slug":"<string>"}'
```

### Get job autocomplete roles

Get a list of common job role slugs available on Wellfound. These slugs can be used to construct Wellfound role search URLs. Returns a static list of the most popular job categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-job-autocomplete-roles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get job details

Retrieve full details of a specific job listing including structured JSON-LD data with title, description, salary, location, and hiring organization. Returns stale_input if the job has been removed (410 Gone) or not found (404).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Job ID from search_jobs results (e.g., '4322508') |
| `job_slug` | string | Yes | Job slug from search_jobs results (e.g., 'software-engineer') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-job-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>","job_slug":"<string>"}'
```

### Get trending jobs

Fetch featured/trending jobs from the Wellfound homepage, organized by category (trending, engineering, product, design, data, sales, marketing, operations, recruiting, finance). Each category contains 3 recently posted job listings with startup information and compensation details. Returns a single page of curated listings refreshed regularly by Wellfound.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-trending-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get trending startups

Fetch trending startups currently hiring from the Wellfound homepage. Returns a curated list of startups that Wellfound is currently featuring, with basic company info and active job counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/get-trending-startups \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search jobs

Search for job listings on Wellfound by role and location. Returns paginated results with job details and associated startup information. Each result includes job title, compensation, location, remote status, and the hiring startup's details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location slug (e.g., 'remote', 'san-francisco', 'new-york-city'). Omitting returns all locations. |
| `page` | integer | No | Page number for pagination. |
| `role` | string | No | Role slug (e.g., 'software-engineer', 'backend-engineer', 'frontend-engineer', 'product-manager') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/wellfound/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","role":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.