> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_people

# search_people

> People by title, company, location or company size: name, title, company and whether a work email exists. Free; no emails or phone numbers.

## What it does

People matching filters (`title`, `company_name` or `company_url`, `locality`, `number_of_employees`, `industry`, each `{include: [...], exclude: [...]}`), in `data[]` with `first_name`, `last_name`, `title`, `company_name`, `company_url`, `industry`, `revenue` and `has_email`, with `meta` (total, `next_cursor`). `has_email: true` keeps only people a work email is known for; `per_page` up to 25. Use it to find who holds a role at a company, then [`find_email`](https://parel.si/docs/tools/find_email.md) for the address and [`verify_email`](https://parel.si/docs/tools/verify_email.md) before sending. It returns no emails or phone numbers itself.

India: `locality: {include: ["Bengaluru"]}` or `["India"]`; use the company's real domain in `company_url`.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `city` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]} |
| `page` | integer | no | e.g. 1. default 1 |
| `title` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["CEO"],"exclude":[]} |
| `bio_li` | object | no | Matches the company's LinkedIn About text, not the person's bio.. e.g. {"include":["payments"],"exclude":[]} |
| `cursor` | string | no | e.g. "opaque cursor from meta.next_cursor" |
| `revenue` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["10 - 20 Million"],"exclude":[]} |
| `locality` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]} |
| `per_page` | integer | no | e.g. 1. default 10; min 1, max 100 |
| `services` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Web Development"],"exclude":[]} |
| `has_email` | boolean | no | e.g. true |
| `company_url` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["stripe.com"],"exclude":[]} |
| `company_name` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Stripe"],"exclude":[]} |
| `country_code` | object | no | e.g. {"include":["US"],"exclude":[]} |
| `industry_linkedin` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Software Development"],"exclude":[]} |
| `number_of_employees` | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["20 - 99"],"exclude":[]} |

## What drives the cost

Nothing: this tool is free, so every call is `class: "ok_free"` with `cost_paise: 0`.

## Price today

| | |
|---|---|
| Price today | **Free** per call (`cost_paise: 0`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_people"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_people"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_people","input":{"title":{"exclude":[],"include":["Marketing"]},"per_page":10,"company_url":{"exclude":[],"include":["zomato.com"]}}}'
```

## What comes back

`data[]` and `meta`. A real answer recorded during the live check of 2026-10-28, trimmed to two people, with the names replaced:

```json
{
  "success": true,
  "message": "Contacts fetched",
  "code": 200,
  "data": [
    {
      "emp_id": 242918829,
      "first_name": "Person",
      "last_name": "One",
      "title": "Marketing Lead - Rider Marketing",
      "employee_linkedin": "N/A",
      "has_email": true,
      "has_phone": false,
      "has_linkedin": false,
      "company_url": "zomato.com",
      "company_name": "Zomato",
      "email_domain": "zomato.com",
      "home_page_email": null,
      "company_linked": "http://www.linkedin.com/company/zomato",
      "company_phone": null,
      "industry": "Technology, Information and Internet",
      "revenue": "500 Million - 1 Billion",
      "employee_count": ">10000",
      "address1": "Pioneer Square",
      "address2": "Suite 111",
      "city": "Badshahpur",
      "region_code": "10",
      "zip": "122101",
      "locality": "N/A",
      "country_code": "IN"
    },
    {
      "emp_id": 225285279,
      "first_name": "Person",
      "last_name": "Two",
      "title": "Senior Manager, Marketing",
      "employee_linkedin": "https://www.linkedin.com/in/jane-example",
      "has_email": true,
      "has_phone": false,
      "has_linkedin": true,
      "company_url": "district.in",
      "company_name": "District By Zomato",
      "email_domain": "zomato.com",
      "home_page_email": null,
      "company_linked": "http://www.linkedin.com/company/district-by-zomato",
      "company_phone": null,
      "industry": "Entertainment Providers",
      "revenue": "100 - 500 Million",
      "employee_count": "1000 - 4999",
      "address1": "District by Zomato, 11th Floor, Block 3, Inte",
      "address2": "N/A",
      "city": "Badshahpur",
      "region_code": "10",
      "zip": "122101",
      "locality": "Gurugram, Haryana, India",
      "country_code": "IN"
    },
    "… 3 more item(s) truncated"
  ],
  "meta": {
    "page": 1,
    "per_page": 5,
    "total": 88,
    "last_page": 18,
    "next_cursor": "WzEwMCwxNzkxMjA2ODgwMzM2XQ",
    "has_more": true
  }
}
```

## Notes

- Free. Names and titles only: find_email gets the address, verify_email checks it.
- per_page up to 25; pass cursor from meta.next_cursor for the next page.
- Usually under two seconds.

## Siblings

- [`count_people`](https://parel.si/docs/tools/count_people.md) to size the audience first.
- [`find_email`](https://parel.si/docs/tools/find_email.md) for one person's address.
