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 returns ten with work history as fields, search_linkedin_people searches by exact name, title or company, search_people lists names by role at one company. Follow up one person at a time with get_linkedin_profile or find_email, 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.

FieldTypeRequiredDescription
objectivestringyesThe people in words: role, company, industry, location.
match_limitintegernoHow 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 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: "list_people_by_description"
Over RESTPOST https://api.parel.si/v1/run with "tool": "list_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":"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:

[
  {
    "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

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