v3
latestOpenAPI 3.1.02026-07-3197486526.1 KBSearch a knowledge store
This method searches a knowledge store using natural language and returns matching video clips and images ranked by relevance.
Provide your natural-language query in the query.text field. Use the filter parameter to choose which items to search: by type of item (the asset_type field) or by specific items (the item_id field). Use the optional search_options parameter to control how videos are matched (by visual content, audio, or both). If you omit it, videos are matched on their visual content. Images are always matched on their visual content.
By default, each result is an individual match: a video clip or an image. Set the group_by parameter to item to group clips under their parent item.
<Note title="Note"> This endpoint is rate-limited. For details, see the [Rate limits](/v1.3/docs/get-started/rate-limits) page. </Note>Path parameters
The unique identifier of the knowledge store.
Headers
Your API key.
<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>Request body
Response
The search completed successfully.