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.

FieldTypeRequiredDescription
cityobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]}
pageintegernoe.g. 1. default 1
titleobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["CEO"],"exclude":[]}
bio_liobjectnoMatches the company's LinkedIn About text, not the person's bio.. e.g. {"include":["payments"],"exclude":[]}
cursorstringnoe.g. "opaque cursor from meta.next_cursor"
revenueobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["10 - 20 Million"],"exclude":[]}
localityobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["San Francisco"],"exclude":[]}
per_pageintegernoe.g. 1. default 10; min 1, max 100
servicesobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Web Development"],"exclude":[]}
has_emailbooleannoe.g. true
company_urlobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["stripe.com"],"exclude":[]}
company_nameobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Stripe"],"exclude":[]}
country_codeobjectnoe.g. {"include":["US"],"exclude":[]}
industry_linkedinobjectnoInclude/exclude string arrays; OR within include, AND across dimensions.. e.g. {"include":["Software Development"],"exclude":[]}
number_of_employeesobjectnoInclude/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 todayFree 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 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"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_people"
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","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

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