# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/builtin/`
**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 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/credits/builtin/get-job-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/builtin/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/builtin/suggest-job-titles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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