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 or search_linkedin_people, and to size a market first use count_people.
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
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:
{
"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_peopleto filter people for free.search_linkedin_peopleto search LinkedIn profiles by filters.find_emailfor one person's work address.
This page as Markdown: /docs/tools/search_people_by_description.md. Something wrong or missing: hello@parel.si.