JavaScript & TypeScript SDK

npm install easytranscriber

import { EasyTranscriber } from "easytranscriber";

const apiKey = process.env.EASYTRANSCRIBER_API_KEY;
if (!apiKey) throw new Error("Configure EASYTRANSCRIBER_API_KEY on the server");
const client = new EasyTranscriber({ apiKey });

const transcript = await client.transcribe({
  url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
});
console.log(transcript.transcript, transcript.credits_used);

// A separate request: 1 additional credit, even for a cached transcript.
const summary = await client.summarize({
  transcript: transcript.transcript,
  video_id: transcript.video_id,
  language: "English",
});
console.log(summary.summary, summary.credits_used);

import { EasyTranscriber, type TranscribeResponse } from "easytranscriber";

async function getTranscript(client: EasyTranscriber): Promise<TranscribeResponse> {
  return client.transcribe({ url: "https://youtu.be/dQw4w9WgXcQ" });
}

// All of these interfaces are exported by "easytranscriber".
interface TranscribeResponse {
  video_id: string;
  video_title: string | null;
  transcript: string;
  method: "yt-dlp" | "innertube" | "deepgram";
  cached: boolean;
  credits_used: number;
}
interface SummarizeResponse {
  summary: string;
  video_id: string | null;
  credits_used: number;
}
interface CreditsResponse { balance: number }

interface SearchResult {
  video_id: string | null;
  channel_id: string;
  title: string;
  channel: string;
  published_at: string;
  thumbnail: string | null;
}
interface SearchResponse {
  results: SearchResult[];
  next_page_token: string | null;
  credits_used: number;
}
interface ResolveChannelResponse {
  channel_id: string;
  name: string;
  handle: string | null;
  subscribers: string | null;
  thumbnail: string | null;
}
interface VideoListItem {
  video_id: string;
  title: string;
  published_at: string;
  thumbnail: string | null;
}
interface LatestVideo extends VideoListItem { thumbnail: string }
interface ChannelLatestResponse {
  channel_id: string;
  videos: LatestVideo[];
}
interface ChannelSearchResponse extends SearchResponse { channel_id: string }
interface ChannelVideosResponse {
  channel_id: string;
  videos: VideoListItem[];
  next_page_token: string | null;
  total_results: number | null;
  credits_used: number;
}
interface PlaylistVideosResponse {
  playlist_id: string;
  videos: VideoListItem[];
  next_page_token: string | null;
  total_results: number | null;
  credits_used: number;
}
interface Comment {
  author: string;
  text: string;
  likes: number;
  published_at: string;
  updated_at: string;
}
interface CommentThread extends Comment {
  reply_count: number;
  replies: Comment[];
}
interface CommentsResponse {
  video_id: string;
  comments: CommentThread[];
  next_page_token: string | null;
  total_results: number | null;
  credits_used: number;
}
interface APIErrorResponse {
  error: { code: string; message: string };
}

import { EasyTranscriber } from "easytranscriber";

const apiKey = process.env.EASYTRANSCRIBER_API_KEY;
if (!apiKey) throw new Error("Configure EASYTRANSCRIBER_API_KEY on the server");
const client = new EasyTranscriber({ apiKey });
const first = await client.channelVideos({ channel: "@GoogleDevelopers" });
console.log(first.videos);

// Explicitly opt into at most one more billed page.
if (first.next_page_token !== null) {
  const second = await client.channelVideos({
    channel: "@GoogleDevelopers",
    page_token: first.next_page_token,
  });
  console.log(second.videos);
}

import {
  EasyTranscriber, APIError, NetworkError, TimeoutError, ResponseError,
} from "easytranscriber";

const apiKey = process.env.EASYTRANSCRIBER_API_KEY;
if (!apiKey) throw new Error("Configure EASYTRANSCRIBER_API_KEY on the server");
const client = new EasyTranscriber({ apiKey, maxRetries: 2 });
try {
  const result = await client.transcribe({ url: "https://youtu.be/dQw4w9WgXcQ" });
  console.log(result.credits_used);
} catch (error) {
  if (error instanceof APIError) {
    if (error.status === 401) console.error("Check the server API key.");
    else if (error.status === 402) console.error("Check your credit balance.");
    else if (error.status === 429) {
      // SDK retries are exhausted or Retry-After exceeds the configured limit.
      console.error("Rate limited; retry delay (ms):", error.retryAfterMs);
    } else if (error.status === 400) console.error("Correct the request:", error.code);
    else console.error("API request failed:", error.status, error.code);
  } else if (error instanceof TimeoutError) {
    console.error("Attempt timed out after", error.timeoutMs, "ms; do not blindly retry.");
  } else if (error instanceof NetworkError || error instanceof ResponseError) {
    console.error("Completion is uncertain; credits may already have been spent.");
  } else {
    throw error;
  }
}