Find buyers
find_buyersWho bought companies of a kind, in one call: the buyers named on every deal whose company matches, counted and ranked, the one on the most deals first. Say the kind of company by words its name holds (company, a list: every trade word the request names, searched together) and by sector (one or a list). Returns how many buyers and deals match, and each buyer with its firm record where it is a firm in the database, how many matching deals it did, its latest, and the companies it bought. With include_contacts, each firm's own mailboxes and phone lines are in its row, using one credit from the account's monthly allowance for each firm opened. Use this, never one search_deals a word, whenever the question is who buys, acquires or invests in companies like these.
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": "find_buyers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Which page of results, from 1. | |
| limit | No | How many buyers to return, 1 to 50. | |
| sector | No | The bought company's sector, or a list of sectors searched together: AI & Data, Aerospace & Defense, Agriculture, Business Services, Construction & Infrastructure, Consumer & Retail, Education, Energy & Power, Financial Services, Food & Beverage, Government & Nonprofit, Healthcare Services, Hospitality & Leisure, Industrials & Manufacturing, Insurance, Life Sciences & Pharma, Media & Entertainment, Medical Devices, Real Estate, Software & IT, Telecom, Transportation & Logistics, Other. With company, a deal must match both. | |
| company | No | Words a bought company's name holds, as a list of up to 20 searched together in this one call: ["utility", "substation", "excavat", "directional"]. A deal matches when its company's name holds any of them, so give every trade word the request names, each in the shortest form that covers its endings ("excavat" finds Excavating and Excavation). Deals carry no NAICS code: words in the name and the sector are how a kind of company is found. | |
| year_to | No | Last year, inclusive. | |
| deal_type | No | Only deals of this kind. | |
| year_from | No | First year, inclusive. | |
| max_value_musd | No | Highest disclosed value, in millions of US dollars. | |
| min_value_musd | No | Lowest disclosed value, in millions of US dollars. Only deals with a disclosed value match. | |
| include_contacts | No | Also return each buyer's own mailboxes and phone lines in its row, where the buyer is a firm in the database. Each firm whose contact is opened uses one credit from the account's monthly allowance, the same credits a person's contact uses; a firm with none on file costs nothing, and one already opened this month is free. Use it only when the person asks for contact details, and say how many credits it used. |