For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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

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

Last updated