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

AlexandriaLead GenAvailable now

People Data Labs · Person enrichment

people-data-labs/person/enrich

Find companies, people and contact details with People Data Labs · Person enrichment from Alexandria through one Spiral API key. Use when you have one identity and want the full record for it. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.104754 per call.

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
lidtext—

LinkedIn numeric id. Sufficient on its own.

nametext—

Full name, or use first_name AND last_name. Enrichment also requires company, school, location, street_address, locality, region, country, postal_code or birth_date. Identify accepts name alone.

emailtext—

Email address. Sufficient on its own.

phonetext—

Phone number. Sufficient on its own, but it must start with + and the country code or nothing matches.

pdl_idtext—

PDL person id, from person/search. A hard override: sent alongside anything else, every other match input is ignored.

regiontext—

State or region. Qualifies as the disambiguator beside a name.

schooltext—

School name or website. Qualifies as the disambiguator beside a name.

companytext—

Employer name or website. Qualifies as the disambiguator beside a name.

countrytext—

Country. Qualifies as the disambiguator beside a name, though it narrows a common name far less than a locality does.

profiletext—

Social profile URL, for example a LinkedIn profile. Sufficient on its own and the most reliable single input.

localitytext—

City. Qualifies as the disambiguator beside a name.

locationtext—

Free-form location, for example "san francisco, california". Qualifies as the disambiguator beside a name.

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.

last_nametext—

Family name. Only counts alongside first_name.

titlecasetrue or falsefalse

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

birth_datetext—

Birth year or date, YYYY or YYYY-MM-DD. Qualifies as the disambiguator beside a name on person/enrich, but never stands alone.

email_hashtext—

Hashed email, SHA-256 or MD5. Sufficient on its own, and the input to use when the raw address must not leave your systems.

first_nametext—

Given name. Requires last_name; enrichment also needs a disambiguator.

middle_nametext—

Middle name. Refines a match and never satisfies the minimum-input rule on its own.

postal_codetext—

Postal code. Qualifies as the disambiguator beside a name, and is assumed to be US unless country is sent too.

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.

street_addresstext—

Street address. Qualifies as the disambiguator beside a name.

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/enrich",
    "input": {
      "pdl_id": "<pdl_id>"
    }
  }'

Frequently asked questions

How much does People Data Labs · Person enrichment cost?

$0.104754 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 · Person enrichment through an API?

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

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

Can my AI agent use People Data Labs · Person enrichment?

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