Express API Server

import type { Request, Response } from 'express'
import { Router } from 'express'
import {
  transcribeVideo,
  listCaptionTracks,
  toSRT,
  toVTT,
} from 'lyra-sdk/transcript'
import { transcriptIdParam, transcriptQuery } from '../schemas/transcript.js'

const router = Router()

router.get('/transcript/:id', async (req: Request, res: Response) => {
  const { id } = transcriptIdParam.parse(req.params)
  const { lang } = transcriptQuery.parse(req.query)
  const lines = await transcribeVideo(id, { lang })
  res.json(lines)
})

router.get('/transcript/:id/languages', async (req: Request, res: Response) => {
  const { id } = transcriptIdParam.parse(req.params)
  const tracks = await listCaptionTracks(id)
  res.json(tracks)
})

router.get('/transcript/:id/srt', async (req: Request, res: Response) => {
  const { id } = transcriptIdParam.parse(req.params)
  const { lang } = transcriptQuery.parse(req.query)
  const lines = await transcribeVideo(id, { lang })
  res.type('text/plain').send(toSRT(lines))
})

router.get('/transcript/:id/vtt', async (req: Request, res: Response) => {
  const { id } = transcriptIdParam.parse(req.params)
  const { lang } = transcriptQuery.parse(req.query)
  const lines = await transcribeVideo(id, { lang })
  res.type('text/plain').send(toVTT(lines))
})

export const transcriptRoutes = router

import { z } from 'zod'

export const transcriptIdParam = z.object({
  id: z.string().min(1, 'Video ID or URL is required'),
})

export const transcriptQuery = z.object({
  lang: z.string().optional(),
})

import type { Request, Response } from 'express'
import { Router } from 'express'
import { client } from '../lib.js'

const router = Router()

router.get('/comments/:videoId', async (req: Request, res: Response) => {
  const { videoId } = req.params
  const maxResults = req.query.maxResults ? Number(req.query.maxResults) : 100
  const threads = await client!.comments(videoId, {
    order: req.query.order as any,
    searchTerms: req.query.search as string,
    maxResults,
  })
  res.json(threads)
})

router.get('/comments/:videoId/top', async (req: Request, res: Response) => {
  const { videoId } = req.params
  const limit = req.query.limit ? Number(req.query.limit) : 10
  const threads = await client!.topComments(videoId, limit)
  res.json(threads)
})

router.get('/comment-replies/:id', async (req: Request, res: Response) => {
  const replies = await client!.commentReplies(req.params.id)
  res.json(replies)
})

export const commentRoutes = router

import type { Request, Response } from 'express'
import { Router } from 'express'
import { transcribePlaylist } from 'lyra-sdk/transcript'
import { z } from 'zod'

const router = Router()

const batchSchema = z.object({
  concurrency: z.coerce.number().min(1).max(20).optional().default(3),
  from: z.coerce.number().min(1).optional(),
  to: z.coerce.number().min(1).optional(),
  lang: z.string().optional(),
})

router.post('/playlist/:id/transcript', async (req: Request, res: Response) => {
  const { id } = req.params
  const opts = batchSchema.parse(req.body)

  const result = await transcribePlaylist(id, {
    apiKey: process.env.YOUTUBE_API_KEY!,
    ...opts,
    onProgress(done, total, videoId, status) {
      console.log(`  [${status}] ${done}/${total} — ${videoId}`)
    },
  })

  res.json(result)
})

export const batchTranscriptRoutes = router

import type { Request, Response } from 'express'
import { Router } from 'express'
import { client } from '../lib.js'

const router = Router()

router.get('/video-categories', async (req: Request, res: Response) => {
  const regionCode = (req.query.regionCode as string) ?? 'US'
  const hl = req.query.hl as string | undefined
  const categories = await client!.videoCategoriesByRegion(regionCode, hl)
  res.json(categories)
})

router.get('/video-category/:id', async (req: Request, res: Response) => {
  const category = await client!.videoCategory(req.params.id)
  res.json(category)
})

export const videoCategoryRoutes = router

import type { Request, Response } from 'express'
import { Router } from 'express'
import { client } from '../lib.js'

const router = Router()

router.get('/regions', async (req: Request, res: Response) => {
  const regions = await client!.regions(req.query.hl as string | undefined)
  res.json(regions)
})

router.get('/languages', async (req: Request, res: Response) => {
  const languages = await client!.languages(req.query.hl as string | undefined)
  res.json(languages)
})

export const i18nRoutes = router

{
  "error": {
    "code": 404,
    "message": "Video not found: INVALID_ID"
  }
}