Use this method to search for relevant matches in an index.

This method returns the first page of results. To retrieve the subsequent pages, you must call the GET method of the /search/{page-token} endpoint, passing it the unique identifier of the page you want to retrieve.


  • This method has a rate limit of 1 call per second for each API key. If the limit is reached, the platform returns an HTTP 429 - Too many requests error response.
  • When you use pagination, you will not be charged for retrieving subsequent pages of results.
  • The Playground is a sandbox environment that allows you to try out the features of the Twelve Labs Video Understanding Platform through an intuitive web page. To search for relevant matches in an index that has been created in the Playground, you must append p to the base URL, as follows: Everything else remains the same.
Click Try It! to start a request and see the response here!