API Documentation

interface VideoInfo {
  id: string;
  title: string;
  author: string;
  description: string;
  thumbnails: Thumbnail[];
  category: string;
  tags: string[];
  duration: number;
  channel: Channel;
  viewCount: number;
  likeCount: number;
  isPrivate: boolean;
  isUnlisted: boolean;
  isFamilySafe: boolean;
  publishDate: PublishDate;
  transcriptLanguages: string[];
  hasTranscripts: boolean;
  captionLanguages: CaptionLanguage[];
  hasCaptions: boolean;
  captionTranslationLanguages: TranslationLanguage[];
}

interface Thumbnail {
  url: string;
  width: number;
  height: number;
}

interface Channel {
  id: string;
  name: string;
  url: string;
}

interface PublishDate {
  text: string;
  date: string;
}

interface CaptionLanguage {
  languageCode: string;
  languageName: string;
}

interface TranslationLanguage {
  languageCode: string;
  languageName: string;
}

interface PlaylistInfo {
  id: string;
  title: string;
  description: string;
  subtitle: string | null;
  author: PlaylistAuthor;
  videoCount: number;
  viewCount: number;
  lastUpdated: string | null;
}

interface PlaylistAuthor {
  id: string;
  name: string;
  url: string;
}

interface TranscriptData {
  language: string;
  transcriptLanguages: string[];
  hasTranscript: boolean;
  segments: TranscriptSegment[];
}

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

interface CaptionDataPayload {
  videoId: string;
  language: string;
  translatedLanguage?: string;
  captions: CaptionSegment[];
}

interface CaptionSegment {
  start: number;
  end: number;
  text: string;
}

interface VideoListResponse {
  videos: VideoListItem[];
  pagination?: {
    nextPageToken?: string;
    totalResults?: number;
  };
}

interface VideoListItem {
  id: string;
  title: string;
  description: string;
  thumbnails: Thumbnail[];
  duration: number;
  publishedAt: string;
  viewCount?: number;
  position?: number; // For playlist videos
}