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

AlexandriaLead GenAvailable now

People Data Labs · Person search

people-data-labs/person/search

Find companies, people and contact details with People Data Labs · Person search from Alexandria through one Spiral API key. Use to build a segment - everyone with a title at a set of companies, in a place - rather than to resolve one person you already have. A known LinkedIn profile belongs on person/enrich. Learn the exact strings to filter on from autocomplete/suggest first, since matches are verbatim. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

Up to $0.087295 per run at the default inputs. $0.087295 per unit of size.

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

SELECT * FROM person WHERE ..., translated to the same query types, so it is strictly less expressive than query. Column selection and LIMIT are ignored, subfields must be addressed in full (experience.title.name IS NOT NULL, not experience IS NOT NULL), and at most 20 LIKE '%...%' terms are allowed. Send this or query, never both.

sizenumber
1 to 100
1

Request 1-2 people per call, costing 50 credits per returned person. The upstream page size is 1-100, but Exchange authorization is capped at 100 credits, so callers must use size 1 or 2. An empty page costs nothing.

queryJSON—

Elasticsearch 7.7 query object over the person schema. Only term, terms, exists, bool, match, range, match_phrase, wildcard, prefix and match_all are accepted - boosting, custom scoring and aggregations are refused. Any array inside it is capped at 1000 elements and the whole request at 20 wildcard terms. Send this or sql, never both: both is a 400.

datasettextresume

Datasets to search, comma-separated, default resume: all, resume, email, phone, mobile_phone, street_address, consumer_social, developer. A leading - on the list switches it to exclusion, written once - all,-phone searches everything but phone.

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.

scroll_tokentext—

The scroll_token from the previous response, replayed with the identical query, to take the next page. Unlimited depth. Stop when it comes back absent, or on a 404 - which here means the scroll is finished, not that anything failed.

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

Frequently asked questions

How much does People Data Labs · Person search cost?

Up to $0.087295 per run at the default inputs. $0.087295 per unit of `size`. 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 search through an API?

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

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

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

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