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.

FieldTypeRequiredDescription
querystringyesThe person in words: role, seniority, place, industry, anything a profile page would say.
numResultsintegernoHow 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_people_by_description"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_people_by_description"
Confirmationnot 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

This page as Markdown: /docs/tools/search_people_by_description.md. Something wrong or missing: hello@parel.si.