[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Built In job search](https://spiral.ai/integrations/codex/built-in-job-search)

# How to Use Built In job search in Codex

Returns matching job URLs and company slugs from Built In's public job listings. Use it to discover roles by keyword, then read the job and company records for context.

|  |  |
| --- | --- |
| Model | Built In job search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Built In job search in Codex

- Use Built In job search to find analytics engineer roles, then add the returned job URLs and company slugs to this project's research dataset.
- Use Built In job search for Kubernetes and create a review table in this project linking each returned role to its employer.
- Use Built In job search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Built In job search and tell me what changed since last week.
- Check Built In job search and summarize what you find in three bullet points.

## How to set up Built In job search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Built In job search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "builtin-com/jobs/search",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: Codex finds Built In job search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Built In job search tools and prices

- [Built In · Search](https://spiral.ai/tools/alexandria/builtin-com/jobs/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 100 | 1 | page |
| query |  | — | query |

## What can you do with Built In job search in Codex?

Build an employer comparison in your project using Built In job listings and company profiles. Turn descriptions, published requirements, and employer context into searchable records for a recruiting or career research tool.

### Build an employer shortlist

Find Python roles, read the requirements, and add each employer's business description and listed employee count to a comparison.

### Prepare for an interview

Find a Datadog opening, examine its responsibilities, and use the company profile to draft questions about the business and the role.

### Research potential recruiting clients

Find employers advertising data engineering roles, review the hiring requirements, and organize the companies by their listed industries and employee counts.

### Plan a career event

Find entry-level opportunities, check the descriptions for experience requirements, and assemble employer briefs for a university career team.

### Study demand for a technical skill

Search for Kubernetes roles, read how employers describe the work, and compare the business types behind the listings.

### Compare competing employers

Find roles at Datadog and Dynatrace, compare the published responsibilities and compensation where available, and add company descriptions for context.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Built In job search in other agents

- [Amp](https://spiral.ai/integrations/amp/built-in-job-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/built-in-job-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/built-in-job-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/built-in-job-search)
- [Cline](https://spiral.ai/integrations/cline/built-in-job-search)
- [Cursor](https://spiral.ai/integrations/cursor/built-in-job-search)
- [Devin](https://spiral.ai/integrations/devin/built-in-job-search)
- [dots](https://spiral.ai/integrations/dots/built-in-job-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/built-in-job-search)
- [Gemini](https://spiral.ai/integrations/gemini/built-in-job-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/built-in-job-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/built-in-job-search)
- [goose](https://spiral.ai/integrations/goose/built-in-job-search)
- [Grok](https://spiral.ai/integrations/grok/built-in-job-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/built-in-job-search)
- [Hermes](https://spiral.ai/integrations/hermes/built-in-job-search)
- [Instinct](https://spiral.ai/integrations/instinct/built-in-job-search)
- [Manus](https://spiral.ai/integrations/manus/built-in-job-search)
- [Muse](https://spiral.ai/integrations/muse/built-in-job-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/built-in-job-search)
- [n8n](https://spiral.ai/integrations/n8n/built-in-job-search)
- [Notion](https://spiral.ai/integrations/notion/built-in-job-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/built-in-job-search)
- [opencode](https://spiral.ai/integrations/opencode/built-in-job-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/built-in-job-search)
- [Raycast](https://spiral.ai/integrations/raycast/built-in-job-search)
- [VS Code](https://spiral.ai/integrations/vscode/built-in-job-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/built-in-job-search)
- [Zapier](https://spiral.ai/integrations/zapier/built-in-job-search)

## More Codex guides

- [Built In job details](https://spiral.ai/integrations/codex/built-in-job-details)
- [CSLB contractor business name search](https://spiral.ai/integrations/codex/cslb-contractor-business-name-search)
- [Built In company profile](https://spiral.ai/integrations/codex/built-in-company-profile)
- [CSLB contractor complaint disclosure](https://spiral.ai/integrations/codex/cslb-contractor-complaint-disclosure)
- [BounceBan email verification](https://spiral.ai/integrations/codex/bounceban-email-verification)
- [CSLB contractor license details](https://spiral.ai/integrations/codex/cslb-contractor-license-details)

## Questions about Built In job search in Codex

**Can Codex use Built In job search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Built In job search like any built-in tool.

**How much does Built In job search cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Built In job search in Codex?**

No. Spiral runs Built In job search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Built In job search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Built In job search runs?**

Built In job search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How broad is Built In's company coverage?**

Built In says it has more than 100,000 company profiles. That figure describes its company directory, not the number of employers currently advertising jobs.

**Does Built In cover employers outside the United States?**

Yes. Built In describes its technology and startup job coverage as global, and its job directory links to markets including Canada, India, Australia, and Singapore.

**How often does Built In receive new job data?**

Built In says new jobs are added daily and schedules a daily sync for employer job integrations. This is a publishing schedule, so it does not establish that every listing reflects an employer's status at this moment.

**Who supplies the company descriptions and job listings?**

Companies can supply their own workplace descriptions and job listings. Built In distinguishes that employer-provided material from its independent reporting and analysis.

**Is Built In limited to software engineering roles?**

No. Its public listings include sales work, such as a Coach Sales Associate III role, alongside engineering jobs.

