Search

Audio-visual deep search across all data layers. The Metadata is extracted and indexed automatically for all Media assets uploaded. This includes transcripts, speakers, videoTexts and many more types of Metadata.

In the most basic variant the search can be done using only the text parameter or a filter, but for achieving the best results there is a wide range of parameters to better narrow down the search results. This includes applying range filters like for example an upper limit to the asset duration: durationto.

curl --request GET \
--url 'https://api.streamdiver.com/v2/search?type=all&text={search-phrase}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}'

📄️ Retrieve a search result

The endpoint returns a ranked list of all `Media` assets within the current authorization scope, that match the search query. The request allows for specifying a search request in terms of text `query`, search `fields`, search `filters`, and has pagination support.

📄️ Semantic search

The endpoint returns a ranked list of all `Media` assets within the current authorization scope, that match the search query. The rank is based on the semantic similarity of the search query to the `Metadata` of the `Media` assets.

📄️ Text semantic search

The endpoint returns a ranked list of all `Media` assets within the current authorization scope, that match the search query. The rank is based on the semantic similarity of the search query to the `Section`s of the `Media` assets.

📄️ Search ranges

Returns possible search ranges like `durationTo` and `fileSizeTo`.

📄️ List saved searches

Returns a list of saved `Search` presets. The available scopes are:

📄️ Save your search

Creates a reusable preset of a `Search` query.

📄️ Update a search preset

Updates a `Search` preset in order to change your saved `Search` request. The available scopes are: -`user`: can be updated by the creator of the `Search` preset. -`tenant`: can be updated by users with role `Tenant Administrator`.

📄️ Delete a search preset

Deletes a `Search` preset by its identifier. The available scopes are: -`user`: can be deleted by the creator of the `Search` preset. -`tenant:` can be deleted by users with role `Tenant Administrator`.