Sample appsIntegrationsDiscordPlaygroundDevEx repo
GuidesSDK ReferenceAPI Reference
GuidesSDK ReferenceAPI Reference
  • TwelveLabs API
    • Introduction
    • Authentication
    • Typical workflows
  • API Reference
    • Manage indexes
    • Upload videos
    • Manage videos
    • Any-to-video search
    • Create video embeddings
    • Create text, image, and audio embeddings
    • Analyze videos
    • Error codes
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
API ReferenceAny-to-video search

GET
https://api.twelvelabs.io/v1.3/search/:page-token
GET
/v1.3/search/:page-token
1curl https://api.twelvelabs.io/v1.3/search/1234567890 \
2 -H "x-api-key: <apiKey>"
Try it
200Retrieved
1{
2 "data": [
3 {
4 "score": 85.08,
5 "start": 238.75,
6 "end": 259.62109375,
7 "video_id": "639963a1ce36463e0199c8c7",
8 "confidence": "high",
9 "thumbnail_url": "https://example.com/thumbnail.jpg"
10 }
11 ],
12 "search_pool": {
13 "total_count": 10,
14 "total_duration": 8731,
15 "index_id": "639961c9e219c90227c371a2"
16 }
17}
Was this page helpful?
Previous

Create video embeddings

Next
Built with
Use this endpoint to retrieve a specific page of search results. <Note title="Note"> When you use pagination, you will not be charged for retrieving subsequent pages of results. </Note>
Retrieve a specific page of search results

Use this endpoint to retrieve a specific page of search results.

Note

When you use pagination, you will not be charged for retrieving subsequent pages of results.

Authentication

x-api-keystring
Your API key. <Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-key" target="_blank">API Key</a> page. </Note>

Path Parameters

page-tokenstringRequired
A token that identifies the page to retrieve.

Query Parameters

include_user_metadatabooleanOptional

Specifies whether to include user-defined metadata in the search results.

Response

Successfully retrieved the specified page of search results.
datalist of objects or null

An array that contains your search results. For each match found, the model returns the following fields:

page_infoobject or null
An object that provides information about pagination.
search_poolobject or null
An object that contains details about the index you queried.

Errors

Your API key.

Note

You can find your API key on the API Key page.

Successfully retrieved the specified page of search results.