> For the complete documentation index, see [llms.txt](https://docs.castmagic.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.castmagic.io/endpoints/search.md).

# Search

Full-text search across transcripts, recordings, and generated content.

Search the caller's transcripts, recordings, and generated content, returning matched snippets with recording ids.

{% hint style="info" %}
**Tier:** `core`. Base URL `https://app.castmagic.io`.
{% endhint %}

## Search

<mark style="color:blue;">`GET`</mark> `https://app.castmagic.io/v1/search`

#### Query Parameters

| Name                                    | Type    | Description                                                |
| --------------------------------------- | ------- | ---------------------------------------------------------- |
| query<mark style="color:red;">\*</mark> | String  | Words to search for                                        |
| category                                | String  | `all` (default) · `transcripts` · `recordings` · `content` |
| space\_id                               | String  | Restrict to one space                                      |
| limit                                   | Integer | Per category, default `5`, max `25`                        |

{% tabs %}
{% tab title="200: OK" %}

```json
{
    "query": "pricing",
    "results": [
        {
            "kind": "transcript",
            "recording_id": "e1...",
            "recording_title": "Episode 12 — Pricing",
            "space": "Acme Podcast",
            "speaker": "Host",
            "start_ms": 154000,
            "snippet": "...our pricing objections came up when..."
        },
        {
            "kind": "recording",
            "recording_id": "e2...",
            "recording_title": "Pricing teardown",
            "space": "Acme Podcast"
        },
        {
            "kind": "output",
            "recording_id": "e1...",
            "recording_title": "Episode 12 — Pricing",
            "space": "Acme Podcast",
            "output_type": "episode_overview",
            "snippet": "This episode covers pricing strategy..."
        }
    ],
    "counts": {
        "transcripts": 1,
        "recordings": 1,
        "content": 1
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
`counts` come from separate capped count queries and are informational only — they may include matches from spaces filtered out of `results`.
{% endhint %}