[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [Akta company lists](https://spiral.ai/integrations/instinct/akta-company-lists)

# How to Use Akta company lists in Instinct

Returns companies matching structured criteria or a plain-language search. Use it to discover businesses in a market before requesting details on the companies worth examining.

|  |  |
| --- | --- |
| Model | Akta company lists |
| Available through | Alexandria |
| Category | News & Media |
| Price | Up to $0.17459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Akta company lists in Instinct

- Every Friday, use Akta company lists to find a matching business software company in Germany and summarize the result for that review.
- Every Monday at 9am: use Akta company lists to look this up and give me the result as a table.
- Pull the latest numbers from Akta company lists and tell me what changed since last week.
- Check Akta company lists and summarize what you find in three bullet points.
- Pull the newest data from Akta company lists and give me the result as a table.

## How to set up Akta company lists 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 Akta company lists**: 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": "akta/companies/list",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## Akta company lists tools and prices

- [Akta · Company list](https://spiral.ai/tools/alexandria/akta/companies/list) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 2 | — | Companies to return. Omission sends 1. Filters allow 2. A query allows 1. Akta's own maximum is 500, and 20 on pay-as-you-go. |
| query |  | — | Natural-language company search. Cannot be combined with filters. limit is capped at 1. |
| offset | 0 to … | 0 | Companies to skip. |
| filters |  | — | Structured filters from companies/filters. Dotted keys such as firmographic.company_type and location.hq.country. Cannot be combined with query. |
| sort_by | relevance, revenue_estimate, valuation_estimate, employee_range, total_funding, founded_year | — | Sort field. Default relevance. |
| sections |  | — | Company sections to attach. Rejected: any section on one company exceeds the 100 Firecrawl credit cap. Use companies/enrich. |

## What can you do with Akta company lists in Instinct?

Prepare a fresh company research brief for each scheduled review of a market or supplier. An always-on agent can repeat an Akta company search and summarize the records returned during that run.

### Compare potential software suppliers

Translate a brief for US business software suppliers into search filters, retrieve matching companies, confirm their identities, and inspect product and technology details for an internal comparison.

### Map a market before researching individual companies

Define a market such as UK business software, build matching company criteria, retrieve candidates, resolve their identities, and examine business models and industry classifications.

### Screen companies for acquisition research

Turn a target-company brief into filters, find candidates, confirm which businesses the results identify, and inspect firmographics and modeled financials for preliminary internal screening.

### Find businesses for partnership research

Describe the industry and location of potential business partners, translate those requirements into filters, retrieve matches, resolve company identities, and review their products and business models.

## Overview

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

## Akta company lists in other agents

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

## More Instinct guides

- [Akta company details](https://spiral.ai/integrations/instinct/akta-company-details)
- [Akta company lookup](https://spiral.ai/integrations/instinct/akta-company-lookup)
- [60.tools WoW Forever talents](https://spiral.ai/integrations/instinct/60-tools-wow-forever-talents)
- [Akta company search filters](https://spiral.ai/integrations/instinct/akta-company-search-filters)
- [60.tools WoW Forever item details](https://spiral.ai/integrations/instinct/60-tools-wow-forever-item-details)
- [Akta industry code search](https://spiral.ai/integrations/instinct/akta-industry-code-search)

## Questions about Akta company lists in Instinct

**Can Instinct use Akta company lists?**

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

**How much does Akta company lists cost in Instinct?**

Up to $0.17459 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 Akta company lists in Instinct?**

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

**How long does it take to set up Akta company lists in Instinct?**

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

**Does Instinct wait while Akta company lists runs?**

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

**Does Akta cover private companies outside the US?**

Yes. Akta documents global coverage of more than 20 million private and public companies, with more than 75 data points in its company data offering.

**Where do Akta company records come from?**

Company enrichment retrieves structured records from Akta's native database. The documented coverage includes both private and public businesses.

**Are Akta revenue and valuation figures reported financial statements?**

Akta describes its financial estimate section as modeled financial performance. It includes revenue, growth rate, valuation, funding, and profitability estimates.

**Does company enrichment return the entire company record?**

It returns only the requested sections. Akta separates company information into sections such as firmographics, business model, financials, products, industry, and technology.

