Count matching people
argorant_count_peopleRead-onlyIdempotent
Count the people in Argorant who match a search by job title, seniority, department, company, industry, keywords, size, revenue or place, without showing anyone. Use it first to size a market or compare searches. Use argorant_preview_people to see example rows, argorant_company_people for one company, and search only for a quick domain lookup. The number counts people, not companies, and is not a company's total staff. It costs no credits and counts toward a free daily safety limit. Count, preview, export and saved lists share the same defaults, so their numbers match. They look only at people with a work email (has_email), leave assistant titles out of a title search (exclude_assistants) and keep private addresses unless business_email_only is true. Plain sector words such as logistics or law firms are matched to industries, and industry_note says how a word was read. A request such as "software companies selling to restaurants" in q, or company_category with sells_to, returns the vendors, never their customers. Most answers come within seconds. When the exact number takes longer, the answer is an estimate with a count_id; call again with only that count_id about a minute later for the exact number. More in the docs at https://docs.argorant.com/docs/agents/tools#read-and-preview
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "argorant_count_people"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text for the search, such as "dental clinics" or a person's job and place. A request such as "software companies selling to restaurants" is read as company_category and sells_to. Prefer the dedicated filters when you know them. | |
| city | No | Cities by name. A comma means any of them. | |
| state | No | States or provinces by name or code, such as Texas or TX. A comma means any of them. | |
| title | No | Job titles to find. A comma means any of them. Short forms work both ways, so CFO also finds Chief Financial Officer. | |
| gender | No | Gender, female or male, based on first name and country. Names used for both women and men are left out. Not available for lending audiences. | |
| radius | No | Distance around the place, between 0.5 and 500. | |
| country | No | Countries, or regions such as Europe, EMEA, DACH, Nordics, Benelux, APAC, LATAM, North America or GCC. A comma means any of them. Regions can overlap. Egypt is in both Middle East and Africa, Mexico is in both North America and LATAM, and Turkey counts as Middle East, not Europe. A person is counted once, even when several of the regions you name include their country. | |
| count_id | No | Only to follow up an earlier count. The count_id from an earlier argorant_count_people answer that was an estimate. Give it alone, without filters, to get that count's exact number or progress. | |
| industry | No | Industries by name, such as Software or Hospitals and Health Care. A comma means any of them. | |
| keywords | No | Words that describe what the company does, such as fintech, MSP or freight forwarding. A comma means any of them. They match the company's name, tags, industry and description, not people's own skills, unless you set where keywords look to people or any. | |
| near_lat | No | Latitude of the place to search around. Use it with near_lon and radius. | |
| near_lon | No | Longitude of the place to search around. Use it with near_lat and radius. | |
| sells_to | No | Who the company sells to, used with company_category. One of restaurants, construction, dentists, salons, auto_repair, hotels, logistics, trades, retailers or smb. It finds the companies that sell, never their customers. | |
| geography | No | The same as country. Countries or regions such as Europe, DACH, Nordics or North America. | |
| has_email | No | true (the default) looks only at people with a work email, like every count, preview, export and list. false also includes people without one. | |
| has_phone | No | true keeps only people with a phone number on file. Phone numbers themselves are only shown when paid for. | |
| seniority | No | How senior the person is. Pick one or more. | |
| near_place | No | A place to search around, written out as a city or a postal code, for example Denver, Colorado or 10115 Berlin. Use it with radius. | |
| departments | No | The person's department. Pick one or more. | |
| founded_max | No | Companies founded in this year or earlier, such as 2020. | |
| founded_min | No | Companies founded in this year or later, such as 2015. Companies whose founding year is not known are left out. | |
| radius_unit | No | Unit of the distance, miles (mi, the default) or kilometers (km). | |
| revenue_max | No | Largest yearly revenue in US dollars, such as 50M. | |
| revenue_min | No | Smallest yearly revenue in US dollars, such as 1M. A company counts when its revenue range overlaps yours. | |
| title_match | No | How a job title must match. words (the default) needs every word as a whole word, so Data does not match Database. exact needs the whole title to be one of the values, so CEO does not match Founder & CEO. contains finds the text anywhere, also inside a word, and is slower. | |
| company_name | No | Company names. A comma means any of them. Prefer company_domain when you know the website. | |
| exclude_city | No | Cities to leave out. A comma means any of them. | |
| has_linkedin | No | true keeps only people with a profile link. | |
| revenue_band | No | Yearly company revenue in US dollars, as bands. Pick one or more. | |
| technologies | No | Technologies the company uses, such as Shopify, HubSpot or AWS. A comma means any of them. | |
| country_match | No | Whose place a country means. person (the default) counts people by where they are based and leaves out people whose own place is not known. person_or_company also counts them by their company's country. | |
| employees_max | No | Largest number of employees, such as 500. | |
| employees_min | No | Smallest number of employees, such as 50. A company counts when its size range overlaps yours. | |
| exclude_state | No | States or provinces to leave out. A comma means any of them. | |
| exclude_title | No | Job titles to leave out, matched the same way as title. A comma means any of them. | |
| keyword_scope | No | Where keywords look. company (the default) looks only at what the company does: its name, tags, industry and description, so a search for MSP finds people at managed service providers. Use people only when the user wants people who have a skill themselves, such as people who know Python or Salesforce admins at any company; it looks only at the person's own skills and profile. any looks at both, plus job titles. Without a value, company is used. | |
| radius_target | No | Whose location counts. any (the default) is where the person is based, or where their company is when their own place is not known. person is only where the person is based, company only where their company is based. | |
| verified_only | No | Deprecated. It has no effect on the search and will be removed. Leave it out. | |
| company_domain | No | Company website domains, such as stripe.com. A comma means any of them. | |
| employee_range | No | Number of employees at the company: size bands (pick one or more), or one text value with a range like "1-500". | |
| industry_match | No | How industries match. any (the default) finds the industry anywhere in what the company is tagged with. primary only counts the company's main industry, so Software and Internet leaves out a retailer or a bank that also carries a software tag. | |
| company_country | No | Countries or regions where the company has its head office, with the same names as country. Use it with country to get people in a country at companies based there. For people it works together with a list of company websites (company_domain) for now. | |
| exclude_country | No | Countries or regions to leave out, matched the same way as country. A comma means any of them. | |
| company_category | No | What kind of company sells, used with sells_to. One of software, payments, pos_payments, business_fintech, accounting_software, payroll_hr_software, formation, association, marketplace or investors. | |
| exclude_industry | No | Industries to leave out, matched the same way as industry. A comma means any of them. | |
| exclude_keywords | No | Words to leave out, matched the same way as keywords. A comma means any of them. | |
| exclude_seniority | No | Seniority levels to leave out. Pick one or more. | |
| exclude_assistants | No | On by default. A job title search leaves out assistant titles such as assistant to, executive assistant or personal assistant. Set it to false to keep them. The answer lists what it left out under applied_defaults, and a saved list keeps the setting. | |
| business_email_only | No | Only people whose email is at their company's own domain. Off unless you set it, so private addresses are left out only on request. When it is on, the answer says so under applied_filters. | |
| exclude_departments | No | Departments to leave out. Pick one or more. | |
| exclude_title_match | No | How the titles to leave out must match, with the same choices. When it is not set, the title choice is used. | |
| exclude_company_domain | No | Company website domains to leave out. A comma means any of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |