# People Data Labs · Company search

Find companies, people and contact details with People Data Labs · Company search from Alexandria through one Spiral API key. Use to find companies by attribute - industry, headcount, funding stage, location - rather than to look one up you can already name. Smaller pages reduce payload size. 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/company/search`
- Page: https://spiral.ai/tools/alexandria/people-data-labs/company/search

## Pricing

Up to $0.078566 per run at the default inputs.

## 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 |
| --- | --- | --- | --- | --- |
| `sql` | text |  | — | `SELECT * FROM company WHERE ...`. Column selection and LIMIT are ignored, and at most 20 LIKE '%...%' terms are allowed. Send this or query, never both. |
| `size` | number | 1 to 100 | 1 | Request 1-2 companies per call, costing 50 credits per returned company. PDL supports 1-100 upstream, but Exchange authorization is capped at 100 credits, so callers must use size 1 or 2. |
| `query` | JSON |  | — | Elasticsearch 7.7 query object over the company schema. Only term, terms, exists, bool, match, range, match_phrase, wildcard, prefix and match_all are accepted. Any array inside it is capped at 100 elements - a tenth of what the person endpoints allow, so a filter list carried over from there will fail. Send this or sql, never both. |
| `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. |
| `scroll_token` | text |  | — | The scroll_token from the previous response, replayed with the identical query, for the next page. A 404 while scrolling means the results are exhausted, not that the query broke. |

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

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

## Common questions

### People Data Labs · Company search

**How much does People Data Labs · Company search cost?**

Up to $0.078566 per run at the default inputs. 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 search through an API?**

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

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

**Can my AI agent use People Data Labs · Company search?**

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

