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

# count_people

> How many people match a company, title, seniority, skill or location filter, before you pay for rows anywhere. Free.

## What it does

How many people match `query` (`currentCompanyWebsite`, `currentJobTitle`, `seniority`, `skills`, `school`, `location`, each `{include: [...], exclude: [...]}`): `data.total`. Use it to size an audience or tune filters before a paid list from [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md) or [`domain_search`](https://parel.si/docs/tools/domain_search.md). It returns the number only.

India: `location: {include: ["India"]}`; use the company's real domain.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | object | yes | e.g. {"currentCompanyWebsite":{"include":["stripe.com"]},"currentJobTitle":{"include":["Engineer"]}} |

## What drives the cost

Nothing: free, 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: "count_people"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "count_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":"count_people","input":{"query":{"currentJobTitle":{"include":["Marketing"]},"currentCompanyWebsite":{"include":["zomato.com"]}}}}'
```

## What comes back

`data.total`. A real answer recorded during the live check of 2026-10-28, trimmed:

```json
{
  "total": 146,
  "success": true
}
```

## Notes

- Free; returns data.total only.
- Filter names: currentCompanyWebsite, currentJobTitle, seniority, skills, school, location, each with include and exclude lists.

## Siblings

- [`search_people`](https://parel.si/docs/tools/search_people.md) for the names behind the number (also free).
- [`domain_search`](https://parel.si/docs/tools/domain_search.md) for the emails.
