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.

Tier: core. Base URL https://app.castmagic.io.

Search

GET https://app.castmagic.io/v1/search

Query Parameters

Name	Type	Description
query*	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

200: OK

{
    "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
    }
}

counts come from separate capped count queries and are informational only — they may include matches from spaces filtered out of results.