Search companies
search_companiesUse this when the user wants to find companies: by a plain-language description, by filters, or by a saved company search. Send exactly one of query, filters, savedSearchId or savedSearchName. Returns one page of companies with their names, domains, industries, number of employees, funding stage and location, and the filters the search ran with; for the next page, send those filters with the page's next cursor. It lists companies, not the people who work at them. Costs $0.001 per company returned, charged to the organization's balance; an empty page is free. Calling again with the same arguments charges again.
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": "search_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Companies per page. The page's most possible cost, `limit` times $0.001, is held from your balance first. | |
| query | No | Which companies to find, in plain language. It is turned into filters, which the page answers with as `filters`. | |
| cursor | No | The `pagination.nextCursor` of the page before. Send it with the same search, as the `filters` the first page answered with. | |
| 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`. |