# GetLeads.io · Contact search

Find companies, people and contact details with GetLeads.io · Contact search from Alexandria through one Spiral API key. Find business contacts by company domain, role, seniority, location, industry, email status, hiring, or funding filters, 100 per page at most. total_available sizes the match set; use next_offset to page. Personal email lists are dropped. 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` / `getleadsio/people/search`
- Page: https://spiral.ai/tools/alexandria/getleadsio/people/search

## Pricing

$0.00873 per call.

## 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 |
| --- | --- | --- | --- | --- |
| `filters` (required) | JSON |  | — | Search filters, such as { "domains": ["stripe.com"], "email_status": ["VALID"] } or { "countries": ["Ireland"], "seniority": ["C-Team"] }. Role, company, industry, technology, geography, email-quality, hiring, funding, revenue, headcount, and exclusion filters are documented by GetLeads.io. Different fields combine with AND; values in one list combine with OR. |
| `limit` | number | 1 to 100 | 25 | Contacts on this page, from 1 to 100. Defaults to 25. |
| `offset` | number | 0 to 49999 | — | Offset from the previous page's next_offset. Walks past 50,000 matches are not reliable. |
| `columns` | list |  | — | Fields to return. Omit for GetLeads.io's default selection. |
| `where_sql` | text |  | — | Optional advanced predicate over GetLeads.io's columns, at most 4000 characters, combined with filters. Prefer filters. |
| `max_per_company` | number | 1 to 50 | — | Most contacts one company can fill on the page, from 1 to 50. |

## 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": "getleadsio/people/search",
    "input": {
      "filters": {}
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=getleadsio%2Fpeople%2Fsearch

## Common questions

### GetLeads.io · Contact search

**How much does GetLeads.io · Contact search cost?**

$0.00873 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 GetLeads.io · Contact search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "getleadsio/people/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 GetLeads.io · Contact search?**

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

**Can my AI agent use GetLeads.io · Contact search?**

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

