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

# list_people_by_description

> A long list of people who match a description: name, profile link and a summary each. Up to 100 per call. No contact details. ₹0.57 per call; a result that finds nothing is ₹0.

## What it does

Up to a hundred people who match a description in plain words, as data[] with name, url (usually a LinkedIn profile) and description, a paragraph of title, company, location and experience as the source found it. No email, phone or personal details.

Use it when you want the long list rather than ten rich records: [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md) returns ten with work history as fields, [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md) searches by exact name, title or company, [`search_people`](https://parel.si/docs/tools/search_people.md) lists names by role at one company. Follow up one person at a time with [`get_linkedin_profile`](https://parel.si/docs/tools/get_linkedin_profile.md) or [`find_email`](https://parel.si/docs/tools/find_email.md), under the Acceptable Use Policy. Flat price per call whatever match_limit says (1 to 100); an empty list is free. Two to five seconds; about 45 KB for fifty people.

India: Indian professionals are well covered; say the city or India in the objective. In the live check 49 heads of marketing at Mumbai skincare brands came back for one call.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `objective` | string | yes | The people in words: role, company, industry, location. |
| `match_limit` | integer | no | How many people at most, 1 to 100. Default 100.; min 5, max 100 |

## What drives the cost

Flat per call for up to 100 people; set match_limit for fewer. An empty list is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.57** per call (`cost_paise: 57`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.86 (`hold_paise: 86`); 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: "list_people_by_description"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "list_people_by_description"` |
| 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":"list_people_by_description","input":{"objective":"heads of marketing at D2C skincare brands in Mumbai","match_limit":50}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
[
  {
    "name": "[name 1]",
    "url": "https://www.linkedin.com/in/example",
    "description": "I lead marketing and P&L at MyMuse, a D2C consumer brand, with ownership across D2C and quick commerce channels. My work covers performance marketing,"
  },
  {
    "name": "[name 2]",
    "url": "https://www.linkedin.com/in/example",
    "description": "Over the last 7+ years, I've worked across D2C and consumer brands, from early-stage startups to companies like Amazon, Bella Vita Organic, and The Ayurveda"
  },
  {
    "name": "[name 3]",
    "url": "https://www.linkedin.com/in/example",
    "description": "Marketing Manager for Beauty & Skincare business with brands Lakme & Ponds at Unilever, Mumbai."
  }
]
```

## Notes

- Flat per call for up to 100 people; set match_limit for fewer. An empty list is free.
- Name, profile link and a text summary only: no contact details. One person at a time from there, under the Acceptable Use Policy.
- About 45 KB for fifty people: over MCP whole entries are dropped from the end to fit, with a _truncated note.

## Siblings

- [`search_people_by_description`](https://parel.si/docs/tools/search_people_by_description.md)
- [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md)
- [`search_people`](https://parel.si/docs/tools/search_people.md)
- [`get_linkedin_profile`](https://parel.si/docs/tools/get_linkedin_profile.md)
- [`find_email`](https://parel.si/docs/tools/find_email.md)
