# People Data Labs · Company enrichment

Find companies, people and contact details with People Data Labs · Company enrichment from Alexandria through one Spiral API key. Use when you have one company and want its firmographics, funding and headcount. Give it a domain, ticker or social profile if you possibly can - a bare name is the identifier most likely to miss. 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` / `people-data-labs/company/enrich`
- Page: https://spiral.ai/tools/alexandria/people-data-labs/company/enrich

## Pricing

$0.078566 per call.

## 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, for example "Google, Inc.". The weakest identifier by a distance - an ambiguous name answers 404 rather than guessing - so prefer website, ticker or profile whenever you have one. |
| `pdl_id` | text |  | — | PDL company id, or a LinkedIn company slug such as `google`. A hard override: sent alongside anything else, every other match input is ignored. |
| `region` | text |  | — | State or region, one value. Never sufficient on its own. |
| `ticker` | text |  | — | Stock ticker. |
| `country` | text |  | — | Country, one value. Never sufficient on its own. |
| `profile` | text |  | — | Social profile URL, for example linkedin.com/company/google. |
| `website` | text |  | — | Company domain. The most reliable single identifier. |
| `locality` | text |  | — | City, one value. Never sufficient on its own. |
| `location` | text |  | — | Free-form location. Raises the likelihood of a name match; never sufficient on its own. |
| `required` | text |  | — | Boolean expression over required top-level output fields using AND, OR and parentheses. Fields used as matching inputs cannot also be required. Access depends on the key's field bundles. |
| `titlecase` | true or false |  | false | Return titlecased values. Responses are lowercase otherwise, which matters when the output is shown to a person rather than matched on. |
| `postal_code` | text |  | — | Postal code, one value. Never sufficient on its own. |
| `data_include` | text |  | — | Comma-separated schema fields to return, dot notation for subfields, a leading `-` to exclude instead, `""` for none. Use it to reduce response size. |
| `min_likelihood` | number | 1 to 10 | 2 | Refuse a match below this confidence, 1-10, default 2. At 2 the match is only 10-30% likely to be the record asked for. Raising it turns a weak match into a 404, which is the cheaper answer: a 404 is free here and a wrong record is not. |
| `street_address` | text |  | — | Street address, one value. Never sufficient on its own. |
| `include_if_matched` | true or false |  | false | Return matching inputs: top-level matched for enrichment, or matched_on within Identify candidates. |

## 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": "people-data-labs/company/enrich",
    "input": {
      "pdl_id": "<pdl_id>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=people-data-labs%2Fcompany%2Fenrich

## Common questions

### People Data Labs · Company enrichment

**How much does People Data Labs · Company enrichment cost?**

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

**How do I use People Data Labs · Company enrichment through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "people-data-labs/company/enrich"` 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 People Data Labs · Company enrichment?**

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

**Can my AI agent use People Data Labs · Company enrichment?**

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

