# Wellfound — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_company_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_job_autocomplete_roles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_job_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_trending_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/get_trending_startups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-wellfound-com-api-d395faef/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","role":"<string>"}'
```