# People Data Labs · Bulk person enrichment

Find companies, people and contact details with People Data Labs · Bulk person enrichment from Alexandria through one Spiral API key. Use to enrich a list rather than looping person/enrich, which throttles. Set `metadata` on every entry so the results can be joined back to your rows. Use smaller batches or data_include to reduce large response payloads. 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/person/bulk`
- Page: https://spiral.ai/tools/alexandria/people-data-labs/person/bulk

## Pricing

Up to $0.087295 per run at the default inputs. Each item in `requests` adds $0.087295.

## 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 |
| --- | --- | --- | --- | --- |
| `requests` (required) | JSON |  | — | 1-100 enrichments, each `{ params: { ...the person/enrich inputs... }, metadata?: {...} }`. Every entry must satisfy the person/enrich minimum-input rule; malformed entries reject the Exchange call locally. `metadata` is echoed back untouched and is the only way to tell which output belongs to which input - the array is in request order, but nothing else identifies a row. |
| `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. |
| `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. Applies to every entry that does not set 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/person/bulk",
    "input": {
      "requests": [
        {}
      ]
    }
  }'
```

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

## Common questions

### People Data Labs · Bulk person enrichment

**How much does People Data Labs · Bulk person enrichment cost?**

Up to $0.087295 per run at the default inputs. Each item in `requests` adds $0.087295. 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 · Bulk person enrichment through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "people-data-labs/person/bulk"` 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 · Bulk person enrichment?**

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

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

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

