get_company_peers
TOOLGet company peersscope: dataflow:entities.search · read-only
Tool description, as exposed to the agent
Returns the peer companies (comparables / competitors) of a publicly listed company, as navigable company_ids with their names and countries resolved. Peers are a curated set of companies considered comparable to the subject — useful for "who else is like this company" traversal. Use search_securities first to obtain the company_id. Each peer row carries a company_id you can pass straight to the ownership, buyback, insider, and other company-scoped tools. Peers with no configured comparables return an empty list. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | required | Company whose peers to return, from search_securities. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| limit | integer | optional | Maximum number of peers, ordered by company name. Hard cap 100.default 25 · min 1 · max 100 |
Billing
Pricing key: profile.peers. Successful calls consume Dataflow credits per your contract. See Credits & pricing.