Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

People Data Labs · Bulk person enrichment

people-data-labs/person/bulk

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.

Pricing

$0.087295 per item in requests.

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
requests requiredJSON—

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.

requiredtext—

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.

titlecasetrue or falsefalse

Return titlecased values. Responses are lowercase otherwise, which matters when the output is shown to a person rather than matched on.

data_includetext—

Comma-separated schema fields to return, dot notation for subfields, a leading - to exclude instead, "" for none. Use it to reduce response size.

min_likelihoodnumber
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_matchedtrue or falsefalse

Return matching inputs: top-level matched for enrichment, or matched_on within Identify candidates.

Same request in code

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": [
        {}
      ]
    }
  }'

Frequently asked questions

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

$0.087295 per item in `requests`. 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.