[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [People Data Labs company search](https://spiral.ai/integrations/opencode/people-data-labs-company-search)

# How to Use People Data Labs company search in opencode

Returns company profiles matching your criteria, plus a total match count and pagination. Use it to find companies by industry, headquarters, employee count, or funding stage.

|  |  |
| --- | --- |
| Model | People Data Labs company search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.078566 per run at the default inputs. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with People Data Labs company search in opencode

- Use People Data Labs company search to find two software companies headquartered in Austin, Texas, with 50 to 500 employees. Add their returned company details to the comparison table in this project.
- Use People Data Labs company search to find two manufacturing companies headquartered in Germany with at least 1,000 employees. Create a populated comparison view using their names, websites, industries, and employee counts.
- Use People Data Labs company search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from People Data Labs company search and tell me what changed since last week.
- Check People Data Labs company search and summarize what you find in three bullet points.

## How to set up People Data Labs company search 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 People Data Labs company 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": "people-data-labs/company/search",
    "input": {
      "query": {}
    }
  }'
```

Then paste one of the prompts above: opencode finds People Data Labs company search on Spiral, shows the price and runs it.

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

## People Data Labs company search tools and prices

- [People Data Labs · Company search](https://spiral.ai/tools/alexandria/people-data-labs/company/search) (Alexandria): Up to $0.078566 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sql |  | — | `SELECT * FROM company WHERE ...`. Column selection and LIMIT are ignored, and at most 20 LIKE '%...%' terms are allowed. Send this or query, never both. |
| size | 1 to 100 | 1 | Request 1-2 companies per call, costing 50 credits per returned company. PDL supports 1-100 upstream, but Exchange authorization is capped at 100 credits, so callers must use size 1 or 2. |
| query |  | — | Elasticsearch 7.7 query object over the company schema. Only term, terms, exists, bool, match, range, match_phrase, wildcard, prefix and match_all are accepted. Any array inside it is capped at 100 elements - a tenth of what the person endpoints allow, so a filter list carried over from there will fail. Send this or sql, never both. |
| titlecase |  | false | Return titlecased values. Responses are lowercase otherwise, which matters when the output is shown to a person rather than matched on. |
| scroll_token |  | — | The scroll_token from the previous response, replayed with the identical query, for the next page. A 404 while scrolling means the results are exhausted, not that the query broke. |

## What can you do with People Data Labs company search in opencode?

Build company comparisons into your project's account views using PDL industry, headquarters, employee counts, and funding summaries. A coding agent can turn returned company records into populated tables and account research pages.

### Fill gaps in company records

Add industry, headquarters, employee count, and funding summaries to known business records. Use company profile matching for identified businesses or company search to find records that meet your criteria.

### Qualify business accounts

Check known accounts against employee count, industry, and headquarters requirements, or find companies that satisfy those requirements. Build a shortlist with the supporting company attributes.

### Plan sales territories

Assign known companies to territories using their headquarters, or discover companies headquartered in a target city or country. Keep headquarters territory separate from office presence.

### Prepare funding research

Review funding summaries for named companies or find businesses at a target funding stage. Compare returned funding dates, stages, and total funding raised before choosing companies for deeper research.

### Compare potential business partners

Create a comparison of known partners or discover candidates by industry and employee count. Use company descriptions, headquarters, and firmographics to explain why each candidate fits.

### Maintain a business directory

Refresh known company entries or find businesses for a defined industry and headquarters region. Populate entries with returned names, domains, descriptions, and company social links.

## Overview

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

## People Data Labs company search in other agents

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

## More opencode guides

- [People Data Labs company profile](https://spiral.ai/integrations/opencode/people-data-labs-company-profile)
- [People Data Labs person enrichment](https://spiral.ai/integrations/opencode/people-data-labs-person-enrichment)
- [People Data Labs bulk person enrichment](https://spiral.ai/integrations/opencode/people-data-labs-bulk-person-enrichment)
- [People Data Labs person search](https://spiral.ai/integrations/opencode/people-data-labs-person-search)
- [Particle weekly top podcast advertisers](https://spiral.ai/integrations/opencode/particle-weekly-top-podcast-advertisers)
- [PredictLeads company discovery](https://spiral.ai/integrations/opencode/predictleads-company-discovery)

## Questions about People Data Labs company search in opencode

**Can opencode use People Data Labs company search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run People Data Labs company search like any built-in tool.

**How much does People Data Labs company search cost in opencode?**

Up to $0.078566 per run at the default inputs. 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 People Data Labs company search in opencode?**

No. Spiral runs People Data Labs company 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 People Data Labs company search in opencode?**

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

**Does opencode wait while People Data Labs company search runs?**

People Data Labs company search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does People Data Labs cover private companies?**

PDL advertises more than 70 million company profiles, ranging from stealth startups to conglomerates. Its coverage extends beyond publicly traded companies.

**How fresh is the company data?**

PDL updates its API data monthly. A company profile reflects that dataset cycle, so it should not be read as a live report of today's business changes.

**Is all the company data publicly sourced?**

No. PDL combines two source categories: proprietary sources and public data sources.

**Why can employee counts differ from LinkedIn?**

PDL calculates employee counts by aggregating its underlying professional profiles and expects discrepancies with LinkedIn. The company size range comes from a self-selected social profile value, so it measures something different.

**Does the main location describe every office?**

The main location describes company headquarters. A search for companies in Austin using that location targets Austin headquarters, rather than every company with an Austin office.

