[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [BlitzAPI companies by employee role](https://spiral.ai/integrations/opencode/blitzapi-companies-by-employee-role)

# How to Use BlitzAPI companies by employee role in opencode

Find distinct companies whose current employees match a role or professional function, with a matching employee count. Use it to find companies that already staff a team rather than companies advertising openings.

|  |  |
| --- | --- |
| Model | BlitzAPI companies by employee role |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with BlitzAPI companies by employee role in opencode

- Use BlitzAPI companies hiring by role and BlitzAPI companies by employee role to find US companies hiring data engineers and companies already employing data engineers. Create an internal comparison report in this project with the matching counts.
- Use BlitzAPI companies by employee role to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from BlitzAPI companies by employee role and tell me what changed since last week.
- Check BlitzAPI companies by employee role and summarize what you find in three bullet points.
- Pull the newest data from BlitzAPI companies by employee role and give me the result as a table.

## How to set up BlitzAPI companies by employee role in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 BlitzAPI companies by employee role**: 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/companies/tam-by-people",
    "input": {
      "cursor": "<cursor>"
    }
  }'
```

Then paste one of the prompts above: opencode finds BlitzAPI companies by employee role on Spiral, shows the price and runs it.

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

## BlitzAPI companies by employee role tools and prices

- [BlitzAPI · Companies by persona](https://spiral.ai/tools/alexandria/blitzapi/companies/tam-by-people) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Cursor from the previous page. Omit it for the first page. |
| people |  | — | Person filters: job_title, job_level, job_function, location, education, and the other fields BlitzAPI documents on this route. |
| company |  | — | Company filters: name, industry, type, employee_range, employee_count, hq, keywords, revenue, funding, and the other fields BlitzAPI documents on this route. |
| 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 companies by employee role in opencode?

Build an internal account research table that connects company identities, business profiles, and workforce signals. A coding agent can join BlitzAPI results to project data so reviewers can compare companies by industry, geography, team composition, and hiring activity.

### Qualify business accounts

Build an industry shortlist, then compare companies already employing a target role with those hiring for it. Resolve company identities, match work email domains, and add profiles plus country and department distributions to an internal qualification report.

### Plan sales territories

Find companies in a target market and compare headquarters with workforce locations and department composition. Add hiring and staffed-role counts, then reconcile website and work email domains before assigning the companies to territories.

### Research potential implementation partners

Find consultancies that employ relevant specialists or are hiring for those skills. Compare company profiles, department composition, and employee countries, then use company pages and email domains to reconcile the shortlist with existing partner records.

### Build an internal vendor shortlist

Search an industry for potential suppliers and examine their existing teams, hiring activity, and geographic footprint. Resolve their company pages, enrich the business profiles, and match work email domains against the procurement directory.

### Compare hiring demand with existing teams

Compare companies advertising data engineering roles with companies already employing data engineers. Add industry, company size, country distribution, and department composition to describe the two account lists.

### Benchmark workforce composition

Build a peer set by industry and company size, or by the roles companies currently employ. Compare department shares and employee countries alongside company profiles for an internal market research report.

## Overview

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

## BlitzAPI companies by employee role in other agents

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

## More opencode guides

- [BlitzAPI LinkedIn profile details](https://spiral.ai/integrations/opencode/blitzapi-linkedin-profile-details)
- [BlitzAPI companies hiring by role](https://spiral.ai/integrations/opencode/blitzapi-companies-hiring-by-role)
- [Aviato work email finder](https://spiral.ai/integrations/opencode/aviato-work-email-finder)
- [BlitzAPI company LinkedIn lookup](https://spiral.ai/integrations/opencode/blitzapi-company-linkedin-lookup)
- [Aviato professional search](https://spiral.ai/integrations/opencode/aviato-professional-search)
- [BlitzAPI company email domain lookup](https://spiral.ai/integrations/opencode/blitzapi-company-email-domain-lookup)

## Questions about BlitzAPI companies by employee role in opencode

**Can opencode use BlitzAPI companies by employee role?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run BlitzAPI companies by employee role like any built-in tool.

**How much does BlitzAPI companies by employee role cost in opencode?**

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 opencode plan is separate.

**Do I need an Alexandria account to use BlitzAPI companies by employee role in opencode?**

No. Spiral runs BlitzAPI companies by employee role on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up BlitzAPI companies by employee role in opencode?**

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

**Does opencode wait while BlitzAPI companies by employee role runs?**

BlitzAPI companies by employee role runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**How many companies does BlitzAPI cover?**

BlitzAPI reports more than 65 million companies in its database. That figure describes database coverage, not guaranteed coverage of every business.

**Where does BlitzAPI get its business data?**

BlitzAPI says it compiles data from publicly available sources and third-party professional sources. The results are compiled business records.

**Does BlitzAPI include consumer information?**

Its stated scope excludes consumer profiles and personal, nonprofessional email addresses. The data is intended for professional B2B research.

**How fresh are BlitzAPI company records?**

BlitzAPI describes company profiles as continuously refreshed through captured signals and recurring update cycles. That description does not specify a fixed refresh interval for every company.

**Are BlitzAPI results guaranteed to be complete?**

No. BlitzAPI explicitly declines to guarantee 100% accuracy or completeness, so a missing company or attribute does not establish that it does not exist.

