List videos | TwelveLabs

curl -G https://api.twelvelabs.io/v1.3/indexes/6298d673f1090f1100476d4c/videos \
     -H "x-api-key: <apiKey>" \
     -d filename=01.mp4 \
     -d "duration[gte]=10" \
     -d "duration[lte]=10" \
     -d "fps[gte]=25" \
     -d "fps[lte]=25" \
     -d "width[gte]=1920" \
     -d "width[lte]=1920" \
     -d "height[gte]=1080" \
     -d "height[lte]=1080" \
     -d "size[gte]=1048576" \
     -d "size[lte]=1048576" \
     --data-urlencode created_at=2024-08-16T16:53:59Z \
     --data-urlencode updated_at=2024-08-16T16:53:59Z

{
  "data": [
    {
      "_id": "62a17bf847f5678267ec10cc",
      "asset_id": "62a17bf847f5678267ec10cc",
      "created_at": "2022-06-09T04:50:00.879Z",
      "updated_at": "2022-06-09T04:55:57.256Z",
      "index_id": "62a0906d47f5678267ec10a6",
      "metadata": {
        "duration": 531.998133,
        "filename": "01.mp4",
        "height": 400,
        "width": 854
      },
      "status": "ready"
    },
    {
      "_id": "62a17bce47f5678267ec10c6",
      "asset_id": "62a17bce47f5678267ec10c6",
      "created_at": "2022-06-09T04:49:20.001Z",
      "updated_at": "2022-06-09T04:54:10.345Z",
      "index_id": "62a0906d47f5678267ec10a6",
      "metadata": {
        "duration": 741.875,
        "filename": "02.mp4",
        "height": 480,
        "width": 854
      },
      "status": "ready"
    }
  ],
  "page_info": {
    "limit_per_page": 10,
    "page": 1,
    "total_page": 1,
    "total_results": 2
  }
}

This method will be deprecated in a future version. New implementations should use the List indexed assets method.

This method returns a list of the videos in the specified index. By default, the platform returns your videos sorted by creation date, with the newest at the top of the list.

<Info>This method will be deprecated in a future version. New implementations should use the [List indexed assets](/v1.3/api-reference/index-content/list) method.</Info> This method returns a list of the videos in the specified index. By default, the platform returns your videos sorted by creation date, with the newest at the top of the list.

Authentication

x-api-keystring

Your API key.

Note

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

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>

Path parameters

index-idstringRequired

The unique identifier of the index for which the platform will retrieve the videos.

Query parameters

pageintegerOptionalDefaults to 1

A number that identifies the page to retrieve.

Default: 1.

page_limitintegerOptionalDefaults to 10

The number of items to return on each page.

Default: 10. Max: 50.

sort_bystringOptionalDefaults to created_at

The field to sort on. The following options are available:

updated_at: Sorts by the time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the item was updated.
created_at: Sorts by the time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the item was created.

Default: created_at.

The field to sort on. The following options are available: - `updated_at`: Sorts by the time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the item was updated. - `created_at`: Sorts by the time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the item was created. **Default**: `created_at`.

sort_optionstringOptionalDefaults to desc

The sorting direction. The following options are available:

asc
desc

Default: desc.

The sorting direction. The following options are available: - `asc` - `desc` **Default**: `desc`.

filenamestringOptional

Filter by filename.

durationobjectOptional

Filter by duration in seconds. Pass an object with gte and/or lte for range filtering. For exact match, set both to the same value.

fpsobjectOptional

Filter by frames per second. Pass an object with gte and/or lte for range filtering. For exact match, set both to the same value.

widthobjectOptional

Filter by width in pixels. Pass an object with gte and/or lte for range filtering. For exact match, set both to the same value.

heightobjectOptional

Filter by height in pixels. Pass an object with gte and/or lte for range filtering. For exact match, set both to the same value.

sizeobjectOptional

Filter by size in bytes. Pass an object with gte and/or lte for range filtering. For exact match, set both to the same value.

created_atstringOptional

Filter videos by the creation date and time of their associated indexing tasks, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”). The platform returns the videos whose indexing tasks were created on the specified date at or after the given time.

updated_atstringOptional

This filter applies only to videos updated using the PUT method of the /indexes/{index-id}/videos/{video-id} endpoint. It filters videos by the last update date and time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”). The platform returns the video indexing tasks that were last updated on the specified date at or after the given time.

This filter applies only to videos updated using the [`PUT`](/v1.3/api-reference/videos/update) method of the `/indexes/{index-id}/videos/{video-id}` endpoint. It filters videos by the last update date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"). The platform returns the video indexing tasks that were last updated on the specified date at or after the given time.

user_metadatamap from strings to strings or doubles or booleansOptional

To enable filtering by custom fields, you must first add user-defined metadata to your video by calling the PUT method of the /indexes/:index-id/videos/:video-id endpoint.

Examples:

To filter on a string: ?category=recentlyAdded
To filter on an integer: ?batchNumber=5
To filter on a float: ?rating=9.3
To filter on a boolean: ?needsReview=true

To enable filtering by custom fields, you must first add user-defined metadata to your video by calling the [`PUT`](/v1.3/api-reference/videos/update) method of the `/indexes/:index-id/videos/:video-id` endpoint. Examples: - To filter on a string: `?category=recentlyAdded` - To filter on an integer: `?batchNumber=5` - To filter on a float: `?rating=9.3` - To filter on a boolean: `?needsReview=true`

Response

The video vectors in the specified index have successfully been retrieved.

datalist of objectsOptional

An array that contains up to page_limit videos.

page_infoobjectOptional

An object that provides information about pagination.

Errors

400

Bad Request Error