find_entities

Overview

The find_entities tool searches for organizations, people, places, and products. Search by name, filters, or both to retrieve matching entity IDs and metadata. Use this tool for entities such as central banks, government bodies, executives, cities, regions, and named products. For companies, ETFs, funds, and other securities, use find_securities instead. Once you have an entity ID, you can use it in entity filters accepted by other Bigdata.com tools.

When to Use

Use find_entities when the user:

Names a person, organization, place, or product that needs to be resolved to an entity ID
Describes entities by attributes, such as cities in a region or people with a particular position
Combines a name with filters to disambiguate similar entities

Parameters

Parameter	Type	Required	Description
`entity_type`	enum	Yes	Entity category: `organization`, `person`, `place`, or `product`.
`query`	string	No	Text to match against an entity’s name or description.
`filters`	object	No	Filters for the selected entity type. Each property accepts an array of complete values.
`max_entities`	integer	No	Maximum number of matching entities to return.

Provide at least one of query or filters.

Filters

Entity type	Filter	Description
`organization`	`types`	Organization classifications, such as `Central Bank` or `Sovereign Wealth Fund`.
`organization`	`countries`	ISO 3166-1 alpha-2 country codes, such as `US`, `FR`, or `GB`.
`organization`	`owners`	Names of owning organizations.
`person`	`positions`	Job titles or roles, such as `Chief Executive Officer`.
`person`	`employers`	Names of employing organizations.
`person`	`nationalities`	Nationalities, such as `American` or `French`.
`person`	`genders`	Gender values.
`place`	`categories`	Broad place categories.
`place`	`types`	Place types, such as `City` or `Country`.
`place`	`continents`	Continent names.
`place`	`countries`	ISO 3166-1 alpha-2 country codes.
`place`	`regions`	Region names, such as `England`.
`product`	`types`	Product classifications.
`product`	`owners`	Names of organizations that own the product.

Filter values must be complete values; they do not perform partial matching. Country filters use ISO 3166-1 alpha-2 codes such as US, FR, and GB.

Use list_entity_filter_values to retrieve accepted values for a filter when the exact spelling or format is unknown.

Data Returned

Each matching entity includes an id, name, and description when available, plus fields specific to its entity type:

Entity type	Additional fields
`organization`	`type`, `country`, `owner`
`person`	`position`, `employer`, `nationality`, `gender`
`place`	`category`, `type`, `continent`, `country`, `region`
`product`	`type`, `owner`

MCP Reference

Tools

Official MCP Integrations

Custom MCP Integrations

Plugins

Prompt examples

Evals

Overview

When to Use

Parameters

Filters

Data Returned

​Overview

​When to Use

​Parameters

​Filters

​Data Returned

Overview

When to Use

Parameters

Filters

Data Returned