# Data Legion · Company enrichment (base)

Find companies, people and contact details with Data Legion · Company enrichment (base) from Alexandria through one Spiral API key. Match a known company using identifiers with the base product. Name matching is global and cannot be narrowed by country, so for non-US or ambiguous names also send the website domain as domain, or the LinkedIn company page URL as social_url. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `datalegion/companies/enrich-base`
- Page: https://spiral.ai/tools/alexandria/datalegion/companies/enrich-base

## Pricing

Up to $0.017459 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `name` | text |  | — | Company name (fuzzy matching) |
| `domain` | text |  | — | Company website domain (e.g., google.com) |
| `industry` | text |  | — | Industry filter (used with name matching for better accuracy) |
| `legion_id` | text |  | — | Company Legion ID (exact match) |
| `titlecase` | true or false |  | false | If true, format text fields in title case (names, company names, locations). Raw fields, IDs, URLs, codes, and confidence fields are excluded. |
| `social_url` | text |  | — | Social profile URL (LinkedIn, Facebook, Crunchbase, X/Twitter, GitHub - will be normalized and detected) |
| `linkedin_id` | text |  | — | LinkedIn company numeric ID |
| `pretty_print` | true or false |  | false | If true, pretty-print JSON response with indentation. |
| `ticker_symbol` | text |  | — | Stock ticker symbol (e.g., GOOGL) |
| `exclude_fields` | text |  | — | Comma-separated list of fields to exclude from response. Applied after include_fields filter. |
| `include_fields` | text |  | — | Comma-separated list of fields to include in response. If omitted, all fields are returned. |
| `min_confidence` | one of | high, moderate, low | — | Minimum match confidence: 'high', 'moderate', or 'low' |
| `required_fields` | text |  | — | Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('domain,socials'), a non-empty list subfield ('socials.network'), or a subfield equal to a value ('type:public', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. |

## Example

```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": "datalegion/companies/enrich-base",
    "input": {
      "name": "<name>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=datalegion%2Fcompanies%2Fenrich-base

## Common questions

### Data Legion · Company enrichment (base)

**How much does Data Legion · Company enrichment (base) cost?**

Up to $0.017459 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Data Legion · Company enrichment (base) through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "datalegion/companies/enrich-base"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Data Legion · Company enrichment (base)?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Data Legion · Company enrichment (base)?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

