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

# search_people_by_description

> People who match a plain-language description, with work history from their public profile. ₹0.79 per call for up to ten.

## What it does

Describe the people you want in words ("head of growth at a D2C skincare brand in Bengaluru"). Each row of `data.results[]` has `title` (the name), `url` (mostly a LinkedIn profile) and `entities[]` with the record found: name, location and dated work history where known.

It never returns an email or a phone number. It takes free text, not filters: for filters use [`search_people`](https://parel.si/docs/tools/search_people.md) or [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md), and to size a market first use [`count_people`](https://parel.si/docs/tools/count_people.md).

India: put the city in the description. Indian professionals are well covered.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The person in words: role, seniority, place, industry, anything a profile page would say. |
| `numResults` | integer | no | How many people, 1 to 10. Default 10.; min 1, max 10 |

## What drives the cost

Nothing you can turn: flat per call for up to ten results, so ask for ten (`numResults` above 10 is refused, free). A description that matches nobody can still return near matches, and those are charged, so check them.

## Price today

| | |
|---|---|
| Price today | **₹0.79** per call (`cost_paise: 79`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹1.19 (`hold_paise: 119`); 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_by_description"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_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":"search_people_by_description","input":{"query":"head of growth at a D2C skincare brand in Bengaluru","numResults":10}}'
```

## What comes back

`data.results[]`. A real answer recorded during the live check of 2026-11-05, trimmed to one row, with the person's name and details replaced:

```json
{
  "results": [
    {
      "title": "Asha Example",
      "url": "https://linkedin.com/in/asha-example",
      "publishedDate": "2026-10-30T15:39:37.000Z",
      "entities": [
        {
          "type": "person",
          "version": 1,
          "properties": {
            "name": "Asha Example",
            "firstName": "Asha",
            "lastName": "Example",
            "location": "Bengaluru, Karnataka, India",
            "workHistory": [
              {
                "title": "Chief Growth Officer",
                "location": "Bengaluru, State of Karnataka, India",
                "dates": {
                  "from": "2025-09-01",
                  "to": null
                },
                "company": {
                  "name": "Example Skincare"
                }
              },
              {
                "title": "Co-founder & CMO",
                "location": "India",
                "dates": {
                  "from": "2023-04-01",
                  "to": null
                },
                "company": {
                  "name": "Example Foods"
                }
              }
            ]
          }
        }
      ]
    }
  ]
}
```

## Notes

- Flat price per call for up to ten results; numResults above 10 is refused as invalid_input (free).
- Never returns an email or a phone number.
- Common names and vague roles return near matches, so check each profile.

## Siblings

- [`search_people`](https://parel.si/docs/tools/search_people.md) to filter people for free.
- [`search_linkedin_people`](https://parel.si/docs/tools/search_linkedin_people.md) to search LinkedIn profiles by filters.
- [`find_email`](https://parel.si/docs/tools/find_email.md) for one person's work address.
