YouTube Transcript API for TypeScript

interface TranscriptSegment {
  text: string;
  start: number;
  duration: number;
}

interface TranscriptResponse {
  title: string;
  channel: string;
  duration: number;
  transcript: TranscriptSegment[];
}

async function getTranscript(videoUrl: string): Promise<TranscriptResponse> {
  const res = await fetch(
    `https://api.youtubetranscripts.co/v1/transcript?url=${encodeURIComponent(videoUrl)}`,
    {
      headers: { "x-api-key": process.env.YT_TRANSCRIPTS_API_KEY! },
    }
  );

  if (!res.ok) {
    throw new Error(`API error: ${res.status}`);
  }

  return res.json() as Promise<TranscriptResponse>;
}

const data = await getTranscript("https://www.youtube.com/watch?v=dQw4w9WgXcQ");
console.log(data.title);
console.log(`${data.transcript.length} segments, ${data.duration}s total`);