---
title: "Search Videos"
method: POST
path: "/api/v1/aRole/twelvelabs/search"
tags: ["aRole"]
---

# Search Videos

`POST /api/v1/aRole/twelvelabs/search`

Search videos in user's TwelveLabs index with optional orientation filter.

Args:
    query_text: The text to search for in the videos
    orientation: Optional filter for video orientation ('horizontal', 'vertical', or 'square')
    db: Database session
    user: The authenticated user
    
Returns:
    JSON response with search results

## Query parameters

- `query_text` string, required
- `orientation` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/ff7f2b621b41/schema)