TranscriptMagic icon

TranscriptMagic

Fetch transcripts from YouTube, TikTok, Instagram, Facebook, LinkedIn, Rumble, and X (Twitter) videos via TranscriptMagic.

Actions8

Transcript → YouTube

AI-generated

Summary

Fetches the transcript of a YouTube video by POSTing its URL to the TranscriptMagic API (/api/youtube/transcript), returning either a simplified object or the raw API response.

Inputs

  • url (required) — The YouTube video URL to transcribe (e.g. https://www.youtube.com/watch?v=…). Whitespace is trimmed; an empty value raises an error.
  • options.outputFormat — Output shape. 'Normalized' (default) returns text, platform, credits and url. 'Raw' returns the upstream API response verbatim.

Output shape

One output item per input item. Normalized: { text, platform: 'youtube', credits, url }. Raw: the unmodified TranscriptMagic API JSON body.

For YouTube, normalized text prefers the API's transcript_only_text field, then falls back to transcript (string or segment array joined by spaces), transcripts, or text; it is an empty string if none exist. credits is a number or null. Requires the transcriptMagicApi credential. On HTTP 429 the node waits for the Retry-After header (default 5s) and retries once; other API errors throw a NodeApiError. With Continue On Fail enabled, failed items return { error: message }.

Examples

Example 1: Get plain transcript text for a YouTube link from an earlier node, to feed into an AI summarizer.

Resource: Transcript; Operation: YouTube; URL: {{ $json.videoUrl }}; Output Format: Normalized.

Example 2: Inspect the full API response, including any segment or timestamp data, for custom parsing.

Resource: Transcript; Operation: YouTube; URL set to the video link; Options > Output Format: Raw.

Links

Discussion