search_people
People by title, company, location or company size: name, title, company and whether a work email exists. Free; no emails or phone numbers.
What it does
People matching filters (title, company_name or company_url, locality, number_of_employees, industry, each {include: [...], exclude: [...]}), in data[] with first_name, last_name, title, company_name, company_url, industry, revenue and has_email, with meta (total, next_cursor). has_email: true keeps only people a work email is known for; per_page up to 25. Use it to find who holds a role at a company, then find_email for the address and verify_email before sending. It returns no emails or phone numbers itself.
India: locality: {include: ["Bengaluru"]} or ["India"]; use the company's real domain in company_url.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
city | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]} |
page | integer | no | e.g. 1. default 1 |
title | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["CEO"],"exclude":[]} |
bio_li | object | no | Matches the company's LinkedIn About text, not the person's bio.. e.g. {"include":["payments"],"exclude":[]} |
cursor | string | no | e.g. "opaque cursor from meta.next_cursor" |
revenue | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["10 - 20 Million"],"exclude":[]} |
locality | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]} |
per_page | integer | no | e.g. 1. default 10; min 1, max 100 |
services | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Web Development"],"exclude":[]} |
has_email | boolean | no | e.g. true |
company_url | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["stripe.com"],"exclude":[]} |
company_name | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Stripe"],"exclude":[]} |
country_code | object | no | e.g. {"include":["US"],"exclude":[]} |
industry_linkedin | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Software Development"],"exclude":[]} |
number_of_employees | object | no | Include/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["20 - 99"],"exclude":[]} |
What drives the cost
Nothing: this tool is free, so every call is class: "ok_free" with cost_paise: 0.
Price today
| Price today | Free per call (cost_paise: 0) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (hold_paise: 38); 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" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_people" |
| 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","input":{"title":{"exclude":[],"include":["Marketing"]},"per_page":10,"company_url":{"exclude":[],"include":["zomato.com"]}}}'
What comes back
data[] and meta. A real answer recorded during the live check of 2026-10-28, trimmed to two people, with the names replaced:
{
"success": true,
"message": "Contacts fetched",
"code": 200,
"data": [
{
"emp_id": 242918829,
"first_name": "Person",
"last_name": "One",
"title": "Marketing Lead - Rider Marketing",
"employee_linkedin": "N/A",
"has_email": true,
"has_phone": false,
"has_linkedin": false,
"company_url": "zomato.com",
"company_name": "Zomato",
"email_domain": "zomato.com",
"home_page_email": null,
"company_linked": "http://www.linkedin.com/company/zomato",
"company_phone": null,
"industry": "Technology, Information and Internet",
"revenue": "500 Million - 1 Billion",
"employee_count": ">10000",
"address1": "Pioneer Square",
"address2": "Suite 111",
"city": "Badshahpur",
"region_code": "10",
"zip": "122101",
"locality": "N/A",
"country_code": "IN"
},
{
"emp_id": 225285279,
"first_name": "Person",
"last_name": "Two",
"title": "Senior Manager, Marketing",
"employee_linkedin": "https://www.linkedin.com/in/jane-example",
"has_email": true,
"has_phone": false,
"has_linkedin": true,
"company_url": "district.in",
"company_name": "District By Zomato",
"email_domain": "zomato.com",
"home_page_email": null,
"company_linked": "http://www.linkedin.com/company/district-by-zomato",
"company_phone": null,
"industry": "Entertainment Providers",
"revenue": "100 - 500 Million",
"employee_count": "1000 - 4999",
"address1": "District by Zomato, 11th Floor, Block 3, Inte",
"address2": "N/A",
"city": "Badshahpur",
"region_code": "10",
"zip": "122101",
"locality": "Gurugram, Haryana, India",
"country_code": "IN"
},
"… 3 more item(s) truncated"
],
"meta": {
"page": 1,
"per_page": 5,
"total": 88,
"last_page": 18,
"next_cursor": "WzEwMCwxNzkxMjA2ODgwMzM2XQ",
"has_more": true
}
}
Notes
- Free. Names and titles only: find_email gets the address, verify_email checks it.
- per_page up to 25; pass cursor from meta.next_cursor for the next page.
- Usually under two seconds.
Siblings
count_peopleto size the audience first.find_emailfor one person's address.
This page as Markdown: /docs/tools/search_people.md. Something wrong or missing: hello@parel.si.