---
title: "Search Media Library"
description: "Deep search across all media transcripts, insights, and metadata."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Media Library

`search_media` is a tool in the Speak AI MCP server. Deep search across all media
transcripts, insights, and metadata.

## What does it do?

Deep search across all media transcripts, insights, and metadata. Returns matching
media with sentiment data, tags, and content excerpts. Use this to find specific
topics, keywords, or themes across your entire library. For filtering by media type,
folder, tags, or speakers, use the filterList parameter. Results are scoped by date
range: defaults to current year if not specified.

## Parameters

`search_media` takes 4 parameters, 1 of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search query: searches across transcripts, insights, and metadata |
| `startDate` | string | No | Start date for search range (ISO 8601). Defaults to start of current year. |
| `endDate` | string | No | End date for search range (ISO 8601). Defaults to now. |
| `filterList` | array of object | No | Advanced filters for narrowing search results by tags, speakers, media type, sentiment, folder, etc. |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `search_media`.

- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Search & analytics](/mcp/tools/search-analytics/) lists the rest of the Search &
  analytics category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/search-analytics/search_media/index.mdx