count_people
How many people match a company, title, seniority, skill or location filter, before you pay for rows anywhere. Free.
What it does
How many people match query (currentCompanyWebsite, currentJobTitle, seniority, skills, school, location, each {include: [...], exclude: [...]}): data.total. Use it to size an audience or tune filters before a paid list from search_linkedin_people or domain_search. It returns the number only.
India: location: {include: ["India"]}; use the company's real domain.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
query | object | yes | e.g. {"currentCompanyWebsite":{"include":["stripe.com"]},"currentJobTitle":{"include":["Engineer"]}} |
What drives the cost
Nothing: free, 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: "count_people" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "count_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":"count_people","input":{"query":{"currentJobTitle":{"include":["Marketing"]},"currentCompanyWebsite":{"include":["zomato.com"]}}}}'
What comes back
data.total. A real answer recorded during the live check of 2026-10-28, trimmed:
{
"total": 146,
"success": true
}
Notes
- Free; returns data.total only.
- Filter names: currentCompanyWebsite, currentJobTitle, seniority, skills, school, location, each with include and exclude lists.
Siblings
search_peoplefor the names behind the number (also free).domain_searchfor the emails.
This page as Markdown: /docs/tools/count_people.md. Something wrong or missing: hello@parel.si.