> 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/overview.md).

# Overview

The Castmagic API turns Castmagic into a programmable pipeline: send audio or video in, and get transcripts (in any format), AI-generated content, translations, and rendered clips back — with webhooks for completion events so you never have to poll the core pipeline.

## What you can do

* [**Transcription**](/endpoints/transcripts.md) — transcribe a public URL directly, with speaker diarization and 18 languages (or auto-detect).
* [**Ingest**](/endpoints/uploads.md) — [upload files](/endpoints/uploads.md) directly to storage or [import from a URL](/endpoints/imports.md) (YouTube, TikTok, Spotify, Google Drive, direct media, and more).
* [**Recordings & spaces**](/endpoints/recordings.md) — create and browse recordings, read transcripts in `json`, `txt`, `vtt`, `srt`, `csv`, `pdf`, or `docx`, and translate them.
* [**Search**](/endpoints/search.md) — full-text search across transcripts, recordings, and generated content.
* [**AI content**](/endpoints/generation.md) — run [saved or one-off prompts](/endpoints/prompts.md) against a recording, or [ask questions](/endpoints/chat.md) grounded in your transcripts.
* [**Speakers**](/endpoints/speakers.md) — manage the speaker directory per space.
* [**Studio**](/endpoints/renders.md) — get AI [clip suggestions](/endpoints/clip-suggestions.md) and render captioned clips and audiograms.
* [**Webhooks**](/reference/webhooks.md) — subscribe to `transcript.completed` and `output.completed` instead of polling.
* [**MCP server**](/reference/mcp.md) — connect Claude or any MCP client with OAuth, no key copying.

## Conventions

* All endpoints live under `https://app.castmagic.io/v1` and speak JSON.
* Endpoints are grouped into **`core`**, **`automation`**, and **`platform`** tiers — your plan unlocks each. See [Plans & Tiers](/reference/plans-and-tiers.md).
* Every request shows up in your live request log at [app.castmagic.io/developer](https://app.castmagic.io/developer).

Continue to the [Quick Start](/quick-start.md) to make your first request.