search_securities
TOOLSearch securitiesscope: dataflow:entities.search · read-only
Tool description, as exposed to the agent
Searches for publicly listed companies and their stocks (share classes) by free-text query. Use this first to obtain the company_id required by other tools such as get_owner_list. The query can be a company name (e.g. 'BP'), stock name, ticker symbol (e.g. 'BP.'), 12-character ISIN (e.g. 'GB0007980591'), or 20-character LEI. Coverage spans publicly listed companies globally, with strong coverage of the UK, Europe, and the US. Each match returns one company plus its associated share classes; a company with multiple share classes (e.g. voting and non-voting shares) returns one entry with multiple stocks. Successful calls may consume Dataflow credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| query | string | required | Free-text query. Accepts a company name, stock name, ticker symbol, 12-character ISIN, or 20-character LEI.min length 2 · max length 256 |
| countries | string[] | optional | Optional ISO 3166-1 alpha-2 filter (e.g. 'GB', 'US', 'DE', 'FR').max items 20 |
| include_unlisted | boolean | optional | When true, also returns companies whose stocks are not currently listed on a public market.default false |
| limit | integer | optional | Maximum number of company matches. Each match may include multiple stocks (share classes), which do not count toward this limit.default 10 · min 1 · max 50 |
Billing
Pricing key: security_search. Successful calls consume Dataflow credits per your contract. See Credits & pricing.