Count companies
count_companiesUse this when the user wants to know how many companies match a search before paying to list them. Send exactly one of query, filters, savedSearchId or savedSearchName, as a company search takes them. A new count runs in the background: while the answer's status is pending, call again with the same arguments every few seconds until the status is ready and the total is there. Free. It returns a number, never the companies.
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": "count_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Which companies to find, in plain language. It is turned into filters, which the page answers with as `filters`. | |
| filters | No | Filters by name. Each filter's allowed values are listed with the company filters and are case-sensitive; company names and headquarters places take a suggested value. | |
| savedSearchId | No | Run a saved company search by its id. | |
| savedSearchName | No | Run a saved company search by its title. A title several saved searches share answers 409 `saved_search_name_ambiguous`. |