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

# API reference

> Nine platforms. Same auth. Per-platform response shapes.

Every endpoint is a `POST` to `https://api.transcriptmagic.com` with `{"url": "..."}` in the body. Auth, path style, and the body field are identical across platforms — but the **response shape differs by platform**, because each upstream source emits different metadata. The per-endpoint pages below document the exact shape you can expect from each.

## Base URL

```
https://api.transcriptmagic.com
```

## Endpoints

| Platform | Path | Guide |
| - | - | - |
| YouTube | `POST /api/youtube/transcript` | [YouTube →](https://docs.transcriptmagic.com/api-reference/youtube.md) |
| TikTok | `POST /api/tiktok/transcript` | [TikTok →](https://docs.transcriptmagic.com/api-reference/tiktok.md) |
| Instagram | `POST /api/instagram/transcript` | [Instagram →](https://docs.transcriptmagic.com/api-reference/instagram.md) |
| Facebook | `POST /api/facebook/transcript` | [Facebook →](https://docs.transcriptmagic.com/api-reference/facebook.md) |
| LinkedIn | `POST /api/linkedin/transcript` | [LinkedIn →](https://docs.transcriptmagic.com/api-reference/linkedin.md) |
| Rumble | `POST /api/rumble/transcript` | [Rumble →](https://docs.transcriptmagic.com/api-reference/rumble.md) |
| X | `POST /api/twitter/transcript` | [X →](https://docs.transcriptmagic.com/api-reference/twitter.md) |
| Twitch (clips) | `POST /api/twitch/transcript` | [Twitch →](https://docs.transcriptmagic.com/api-reference/twitch.md) |
| Kick (clips) | `POST /api/kick/transcript` | [Kick →](https://docs.transcriptmagic.com/api-reference/kick.md) |
| Spotify | `POST /api/podcast/transcript` | [Spotify →](https://docs.transcriptmagic.com/api-reference/spotify.md) |
| Apple Podcasts | `POST /api/podcast/transcript` | [Apple Podcasts →](https://docs.transcriptmagic.com/api-reference/apple-podcasts.md) |

> [!NOTE]
>
> The social-video endpoints above are synchronous — one request returns the transcript. **Podcast** transcription (Spotify, Apple Podcasts) is asynchronous: submit an episode, then poll `GET /api/podcast/jobs/{jobId}`. It's a Plus/Pro feature billed at 10 credits per audio-hour. See the [Spotify](https://docs.transcriptmagic.com/api-reference/spotify.md) and [Apple Podcasts](https://docs.transcriptmagic.com/api-reference/apple-podcasts.md) guides.

## Request

All endpoints accept the same body and headers.

**Headers**

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

**Body**

```json theme={null}
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

## Response

All endpoints return `200 OK` on success and always include a `credits` field with your remaining balance. Beyond that, the shape varies:

| Platform | `transcript` type | Per-line timing | Video URLs included |
| - | - | - | - |
| YouTube | array of segment objects | yes (`startMs`, `endMs`, `startTimeText`) | no |
| TikTok | string (newline-joined) | no | yes (Plus and Pro, in `videoUrls`) |
| Instagram | array of `{text}` objects (under `transcripts`, plural) | no | no |
| Facebook | string (newline-joined) | no | yes (Plus and Pro, in `videoUrls`) |
| LinkedIn | string (newline-joined) | no | no |
| Rumble | string (newline-joined) | no | no |
| X | string (newline-joined) | no | no |
| Twitch | string | no | no |
| Kick | string | no | no |

See the [response schema](https://docs.transcriptmagic.com/api-reference/response-schema.md) page for the full per-platform field reference, or jump into a per-endpoint page for a real example payload.

## Errors

All endpoints share the same error vocabulary — see [errors](https://docs.transcriptmagic.com/concepts/errors.md) for the full table. The most common ones:

* `400` — bad URL in the body (including Twitch/Kick VOD or channel URLs — only clips are accepted), missing `url`, or invalid JSON
* `401` — missing or invalid API key
* `403` — out of credits (`error: "no_credits"`)
* `404` — upstream says the video is missing, private, or has no captions
* `429` — over the rate limit
* `502` — upstream platform HTTP error (retry with backoff)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.