[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [LeadOcean company count](https://spiral.ai/integrations/instinct/leadocean-company-count)

# How to Use LeadOcean company count in Instinct

Returns matching company totals with industry, headcount, headquarters and NAICS breakdowns. Use it to size a business segment before retrieving individual company records.

|  |  |
| --- | --- |
| Model | LeadOcean company count |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.013 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with LeadOcean company count in Instinct

- Each month, use LeadOcean company count for Software Development companies headquartered in Texas. Compare the total and returned company-size breakdown with the previous run.
- Every Monday at 9am: use LeadOcean company count to look this up and give me the result as a table.
- Pull the latest numbers from LeadOcean company count and tell me what changed since last week.
- Check LeadOcean company count and summarize what you find in three bullet points.
- Pull the newest data from LeadOcean company count and give me the result as a table.

## How to set up LeadOcean company count 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 LeadOcean company count**: 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": "leadocean/companies/count",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Instinct finds LeadOcean company count on Spiral, shows the price and runs it.

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

## LeadOcean company count tools and prices

- [LeadOcean · Company count](https://spiral.ai/tools/alexandria/leadocean/companies/count) (Alexandria): $0.013 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free text over the company name and description. |
| sic |  | — | SIC codes. |
| name |  | — | Company name phrase. Wrap a value in [brackets] for an exact name. |
| slim |  | — | Accepted by the count route. The response is the totals, not company rows. |
| naics |  | — | NAICS codes. Any code the company carries. |
| domain |  | — | Company website domains, without a scheme or path. |

## What can you do with LeadOcean company count in Instinct?

Produce a recurring business research digest from LeadOcean company data. A scheduled agent can compare repeated company counts or company records and report aggregate role patterns without tracking individuals.

### Research potential business partners

Count software companies in a target state, search for relevant businesses, and inspect company details. Summarize the business roles represented in LeadOcean's staff records to prepare a partnership research brief.

### Assess a regional business market

Compare company counts across headquarters states, inspect matching businesses, and review their firmographics. Add an aggregate summary of represented staff roles at selected companies to describe the organizations in the sample.

### Prepare an event sponsor shortlist

Size a relevant industry segment, discover candidate businesses, and review company details for sponsor fit. Summarize represented business functions at shortlisted companies for the event planning brief.

### Build a competitor landscape

Count companies matching a business description, inspect search results, and compare individual company records. Use aggregate role summaries from company staff records as additional organizational context.

### Check a market definition against real companies

Count a proposed business segment and inspect matching company records. Use the count breakdowns and company descriptions to judge whether the query captures the intended market.

## Overview

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

## LeadOcean company count in other agents

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

## More Instinct guides

- [Latvia registry publication status](https://spiral.ai/integrations/instinct/latvia-registry-publication-status)
- [LeadOcean company details](https://spiral.ai/integrations/instinct/leadocean-company-details)
- [Latvia company shareholders](https://spiral.ai/integrations/instinct/latvia-company-shareholders)
- [LeadOcean company people](https://spiral.ai/integrations/instinct/leadocean-company-people)
- [Latvia company register](https://spiral.ai/integrations/instinct/latvia-company-register)
- [LeadOcean company search](https://spiral.ai/integrations/instinct/leadocean-company-search)

## Questions about LeadOcean company count in Instinct

**Can Instinct use LeadOcean company count?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run LeadOcean company count like any built-in tool.

**How much does LeadOcean company count cost in Instinct?**

$0.013 per call. 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 LeadOcean company count in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs LeadOcean company count on its own Alexandria account.

**How long does it take to set up LeadOcean company count in Instinct?**

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

**Does Instinct wait while LeadOcean company count runs?**

LeadOcean company count runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**How many companies does LeadOcean cover?**

LeadOcean reports 73,728,117 companies in its search index as of November 13, 2026. That is the indexed company population, not a claim that every business is included.

**Where does LeadOcean's data come from?**

LeadOcean names three sources: publicly accessible professional information on the web, its own collection and verification, and licensed data partners. Its privacy policy describes the database as business-context information.

**What does a company record contain?**

Company details include industry, headcount, headquarters, revenue, funding and detected website technologies where available. Company search returns matching company records, while company count returns totals and breakdowns without company rows.

**Does LeadOcean provide a complete employee directory?**

The company people endpoint lists the people LeadOcean holds at a domain. It returns thin professional records without contact points, so the result should be described as LeadOcean's represented staff data.

**How detailed are the company count breakdowns?**

Company count provides five breakdowns: industry, headcount band, headquarters country, headquarters state and primary NAICS code. Each breakdown contains its top 20 entries.

