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

# YouTube

> Fetch YouTube transcripts and video metadata in the format your automation needs.

The YouTube group powers the **MMK YouTube Transcript** Make.com app. Identify a video by
either its full URL (`video_url`) or its 11-character ID (`video_id`), and get the
transcript back as XML, JSON, VTT, or SRT. All routes are `POST` under `/api/v1` and
authenticate with the `X-API-KEY` header (see [Authentication](/authentication)).

## Endpoints

| Endpoint                      | Tier    | What it does                                                      |
| ----------------------------- | ------- | ----------------------------------------------------------------- |
| `POST /youtube/transcript/v2` | Basic   | Get a video's transcript in `xml` / `json` / `vtt` / `srt`        |
| `POST /youtube/metadata`      | **Pro** | Get title, author, thumbnails, channel info, and view/like counts |

<Note>
  `youtube/metadata` requires a **Pro** license — a Basic key gets `403 Pro account required`.
  The same applies to the `with_metadata` option on the transcript endpoint: the transcript
  itself returns on Basic, but the `metadata` block is filled only for Pro keys (Basic sees
  an upgrade placeholder). See [Authentication](/authentication).
</Note>

## Notes

* **Pick one identifier.** Send either `video_url` or `video_id` — not both required.
* **Format** defaults to `xml`. Choose `json` for structured segments with start/duration,
  or `srt` / `vtt` when you need subtitle files.
* **Rate limited.** Both endpoints are rate limited; space out bulk calls.
* **`retry_info`** in every response reports fetch attempts — useful when a transcript is
  temporarily unavailable and you want to retry.

Use the interactive playground on each endpoint page to try a request with your own
deployment host and API key.