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

AlexandriaLead GenAvailable now

People Data Labs · Company enrichment

people-data-labs/company/enrich

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.

Pricing

$0.078566 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
nametext—

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

PDL company id, or a LinkedIn company slug such as google. A hard override: sent alongside anything else, every other match input is ignored.

regiontext—

State or region, one value. Never sufficient on its own.

tickertext—

Stock ticker.

countrytext—

Country, one value. Never sufficient on its own.

profiletext—

Social profile URL, for example linkedin.com/company/google.

websitetext—

Company domain. The most reliable single identifier.

localitytext—

City, one value. Never sufficient on its own.

locationtext—

Free-form location. Raises the likelihood of a name match; never sufficient on its own.

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.

postal_codetext—

Postal code, one value. Never sufficient on its own.

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, one value. Never sufficient on 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/company/enrich",
    "input": {
      "pdl_id": "<pdl_id>"
    }
  }'

Frequently asked questions

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.