[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [BlitzAPI job search](https://spiral.ai/integrations/instinct/blitzapi-job-search)

# How to Use BlitzAPI job search in Instinct

Returns live job postings across companies, including the hiring company, title, location, posting date, link, and AI summary. Use it to find businesses advertising specific roles or skills across a market.

|  |  |
| --- | --- |
| Model | BlitzAPI job search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with BlitzAPI job search in Instinct

- Every Monday, use BlitzAPI job search to find security engineer openings in the United States posted during the past seven days. Group the digest by company.
- Every Friday, use BlitzAPI job search to find data engineer openings in Toronto posted during the past seven days. Summarize the roles by employer and retain posting links for the next comparison.
- Every Monday at 9am: use BlitzAPI job search to look this up and give me the result as a table.
- Pull the latest numbers from BlitzAPI job search and tell me what changed since last week.
- Check BlitzAPI job search and summarize what you find in three bullet points.

## How to set up BlitzAPI job search in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 BlitzAPI 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": "blitzapi/jobs/search",
    "input": {
      "job": {}
    }
  }'
```

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

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

## BlitzAPI job search tools and prices

- [BlitzAPI · Job search](https://spiral.ai/tools/alexandria/blitzapi/jobs/search) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| job |  | — | Job filters: title, description, seniority, location, and date_posted.last_days. Field names are BlitzAPI's. |
| cursor |  | — | Cursor from the previous page. Omit it for the first page. |
| company |  | — | Firmographic filters for the hiring company: industry, employee_count, size, keywords, hq, and mx. |
| max_results | 1 to 10 | 10 | Results to return, from 1 to 10. BlitzAPI allows a larger page; this connector stops at 10 so a call stays within 100 Firecrawl credits. Each returned record costs 10 credits. An empty page costs nothing. Omitting it requests 10. The upstream maximum is 50. |

## What can you do with BlitzAPI job search in Instinct?

Produce a recurring digest of newly observed job postings at target businesses. A scheduled agent can compare BlitzAPI posting links between runs and summarize changes in advertised roles and locations.

### Prepare an account hiring brief

Summarize a target company's advertised roles by location and posting date. Include posting links so an account team can review the openings behind the brief.

### Find demand for a recruiting specialty

Find businesses advertising roles such as security engineer or financial controller. Review the returned summaries to decide which companies fit a recruiting team's specialty.

### Research advertised technology requirements

Review job summaries for mentions of Kubernetes, Python, or other tools relevant to your business. Keep each finding tied to its posting and label it as an advertised requirement.

### Compare hiring locations

Group returned postings by company and location to see where businesses are advertising roles. Use the comparison to guide further territory or expansion research.

### Flag new roles at target accounts

Compare recurring results by posting URL and flag newly observed openings. Give the account team the title, date, location, and summary for each new finding.

### Build an internal hiring research dashboard

Organize retrieved postings by employer, role, location, and posting date. Let internal researchers open the original posting from each row.

## Overview

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

## BlitzAPI job search in other agents

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

## More Instinct guides

- [BlitzAPI employee profiles](https://spiral.ai/integrations/instinct/blitzapi-employee-profiles)
- [BlitzAPI professional search](https://spiral.ai/integrations/instinct/blitzapi-professional-search)
- [BlitzAPI company search](https://spiral.ai/integrations/instinct/blitzapi-company-search)
- [BlitzAPI profile from US phone number](https://spiral.ai/integrations/instinct/blitzapi-profile-from-us-phone-number)
- [BlitzAPI company profile](https://spiral.ai/integrations/instinct/blitzapi-company-profile)
- [BlitzAPI profile from work email](https://spiral.ai/integrations/instinct/blitzapi-profile-from-work-email)

## Questions about BlitzAPI job search in Instinct

**Can Instinct use BlitzAPI job search?**

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

**How much does BlitzAPI job search cost in Instinct?**

Up to $0.034918 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use BlitzAPI job search in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs BlitzAPI job search on its own Alexandria account.

**How long does it take to set up BlitzAPI job search in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while BlitzAPI job search runs?**

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

**How large is BlitzAPI's job dataset?**

BlitzAPI advertises more than 100 million job postings. Both job endpoints read the same postings layer.

**How fresh are the job postings?**

BlitzAPI describes its company job data as refreshed hourly and says every jobs endpoint reads the same continuously refreshed postings layer.

**Do results include the full job description?**

Results include an AI summary instead of the full description. Each posting also includes its title, company, location, posting date, and original posting URL.

**Can I retrieve every matching job in a broad search?**

Each query is capped at 5,000 jobs across its pages. This limit applies to both market searches and company job searches.

**How do I know when I have reached the last page?**

The response cursor becomes null at the end of the results. Keep requesting pages while a continuation cursor remains, subject to the 5,000-job query limit.

