API Reference

Manage entities

The Entity Search feature is currently in beta.

Entities represent specific persons that you want to find in your videos. Each entity is part of an entity collection and contains one or more assets that help identify the person. Each asset is an image. Entities serve as the searchable units, and you can reference them in your search queries.

Notes
  • The Marengo 3.0 video understanding engine must be enabled in your index.
  • The platform automatically creates a sample entity collection when you create your account. Users on the Free plan can have a total of one entity collection with up to fifteen entities. The default collection is included in this limit. To create more entity collections, upgrade to the Developer plan. For instructions, see the Upgrade your plan section.

To find entities in your video content, follow the steps below:

1

Create an entity collection to group related people.

2

Create assets (reference images) for each person.

3

Create entities and link them to their assets.

4

Use entity IDs in search queries with the format <@entity_id>.