The endpoints that return lists of items support filtering. The examples in this section are specific to listing your video indexing tasks. The same principles apply to other similar endpoints.

Note

Depending on the endpoint, you can filter on various fields.

Prerequisites

You’re familiar with the concepts that are described on the Platform overview page.
You’ve already created an index and uploaded at least one video to it.

Examples

Filter on a specific date

The following example code uses the created_at parameter to return all the tasks created on a specific date:

1 from twelvelabs import TwelveLabs
2 
3 client = TwelveLabs(api_key="<YOUR_API_KEY>")
4 
5 tasks = client.task.list_pagination(
6   created_at="2022-05-17"
7   )
8 
9 # Utility function to print a specific page
10 def print_page(page):
11   for task in page:
12     print(f"id={task.id} status={task.status} created_at={task.created_at}")
13 
14 print_page(tasks.data)
15 
16 while True:
17     try:
18         print_page(next(tasks))
19     except StopIteration:
20         break

The following example output was truncated for brevity:

  id=6283ab5ef18e21febd160bc3 status=ready created_at=2022-05-17T14:04:14.001Z
  id=6283a0a8f18e21febd160bbf status=ready created_at=2022-05-17T13:18:32.388Z
  id=6283a00df18e21febd160bbc status=ready created_at=2022-05-17T13:15:57.053Z

Filter based on a file name

To filter based on a file name, use the filename parameter as shown in the example below:

1 from twelvelabs import TwelveLabs
2 
3 client = TwelveLabs(api_key="<YOUR_API_KEY>")
4 
5 tasks = client.task.list_pagination(
6   filename="<YOUR_FILENAME>" # Example: filename="01.mp4"
7   )
8 
9 # Utility function to print a specific page
10 def print_page(page):
11   for task in page:
12     print(f"id={task.id} status={task.status} created_at={task.created_at}")
13 
14 print_page(tasks.data)
15 
16 while True:
17     try:
18         print_page(next(tasks))
19     except StopIteration:
20         break

The following output was truncated for brevity:

id=65e5ae52bb29f13bdd6f37c8 status=ready created_at=2024-03-04T11:19:46.901Z
id=65d46ef879384c4778ab30fa status=ready created_at=2024-02-20T09:20:56.321Z

Filter based on duration

To filter based on the duration of a video, use the duration parameter. The example below displays all the videos of a specific duration (810 seconds):

1 from twelvelabs import TwelveLabs
2 
3 client = TwelveLabs(api_key="<YOUR_API_KEY>")
4 
5 tasks = client.task.list_pagination(
6   duration=810
7   )
8 
9 # Utility function to print a specific page
10 def print_page(page):
11   for task in page:
12     print(f"id={task.id} status={task.status} created_at={task.created_at}")
13 
14 print_page(tasks.data)
15 
16 while True:
17     try:
18         print_page(next(tasks))
19     except StopIteration:
20         break

The following example output was truncated for brevity:

id=65e5ae52bb29f13bdd6f37c8 status=ready created_at=2024-03-04T11:19:46.901Z 
id=65d46ef879384c4778ab30fa status=ready created_at=2024-02-20T09:20:56.321Z

1	from twelvelabs import TwelveLabs
2
3	client = TwelveLabs(api_key="<YOUR_API_KEY>")
4
5	tasks = client.task.list_pagination(
6	created_at="2022-05-17"
7	)
8
9	# Utility function to print a specific page
10	def print_page(page):
11	for task in page:
12	print(f"id={task.id} status={task.status} created_at={task.created_at}")
13
14	print_page(tasks.data)
15
16	while True:
17	try:
18	print_page(next(tasks))
19	except StopIteration:
20	break