# Search videos (`search_videos`)
> Searches a workspace across titles, descriptions, tags, and transcript text, newest first and paginated. Leave the query empty to list everything.
- Area: [Library & discovery](https://mcp.dadan.io/tools/library.md)
- Access: Read-only
- AI credits: no
- Available on read-only connections: yes

## Example prompt
"Find my videos that mention the pricing update"

## Parameters
- `query` (string): Search terms matched against title, description, tags, and transcript. Omit to list all videos.
- `workspace_id` (string): Workspace id. Omit to use the user's default workspace.
- `folder_id` (string): Restrict results to one folder (id from list_folders).
- `limit` (integer): Page size, 1-100. Default 20.
- `cursor` (string): Pagination cursor from the previous page's next_cursor.

## Description for AI assistants
Search videos in a Dadan workspace by title, description, tags, and transcript text. Returns newest first. Omit the query to list all videos. Results are paginated; pass next_cursor from the previous page to continue. VISUAL TOOL: the result renders as an interactive card in the chat in clients that support MCP Apps. Call it whenever the user wants to SEE this — do not answer from prior context. After it returns, reply with ONE short sentence; the card shows the details, so never repeat its titles, links, or stats as text.


## Known limitations

- Matches on transcript text as well as title, so a query can return videos whose titles don't contain the term.
Canonical page: https://mcp.dadan.io/tools/search-videos
