Search 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.
Changes
Changed in 3 of the 9 revisions of this API.232
- ▲
the
query/textrequest property's minLength was increased from0to1request-property-min-length-increased
- ▲
added
subschema #1subschema #2to thedata/items/response propertyoneOflist for the response status200response-property-one-of-added
- ●
the
page_sizerequest property's max was set to50.00request-property-max-set
- ●
the
page_sizerequest property's min was set to1.00request-property-min-set
- ○
removed
subschema #1subschema #2from thedata/items/response propertyoneOflist for the response status200response-property-one-of-removed
- ▲
- ●
removed the optional property
docs_urlfrom the response with the400statusresponse-optional-property-removed
- ●
- ○
endpoint added
endpoint-added
This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○