# Builtin — 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 browse tech job listings on Built In to find opportunities that match your skills, then view detailed information about positions including company profiles, salary ranges, benefits, and direct application links. Get job title suggestions to refine your search and discover relevant roles across the tech industry.

**Category:** Jobs | **Website:** [builtin.com/](https://builtin.com/) | **Docs:** [parse.bot/marketplace/86aeeb18-5f5a-47c4-a057-098e2d8785f1/builtin-com-api](https://parse.bot/marketplace/86aeeb18-5f5a-47c4-a057-098e2d8785f1/builtin-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-builtin-com-api-86aeeb18/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_job_details

Fetch the full detail view of a single job posting by its URL path. Returns structured data extracted from the page's JSON-LD and inline scripts, including full HTML description, salary range, benefits, location coordinates, education/experience requirements, and a direct application link. The job_url is obtained from search_jobs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_url` | string | Yes | Job URL path from search_jobs results (e.g. '/job/software-engineer/3985663' or full URL) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-builtin-com-api-86aeeb18/get_job_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_url":"<string>"}'
```

### search_jobs

Full-text search over Built In job listings with optional filters for work type and location. Returns paginated results (up to 25 per page). Query matches job titles and descriptions. Omitting all filters returns all available listings. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | City name to filter results by geographic location |
| `page` | integer | No | Page number for pagination (1-based) |
| `query` | string | No | Search keyword matching job titles and descriptions |
| `work_type` | string | No | Work arrangement filter. Empty string returns all types. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-builtin-com-api-86aeeb18/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>","work_type":"<string>"}'
```

### suggest_job_titles

Returns up to 10 autocomplete suggestions for job title searches, matching the query prefix against Built In's job title index. Useful for building type-ahead search interfaces.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial job title prefix to get suggestions for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-builtin-com-api-86aeeb18/suggest_job_titles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```