MyTube/documents/en/api-endpoints.md

API Endpoints

Video Download & Search

• GET /api/search - Search for videos online (YouTube)
  • Query params: query (required), limit (optional, default: 8), offset (optional, default: 1)
• POST /api/download - Download a video from supported platforms
  • Body: { url: string, ...options }
  • Supports: YouTube, Bilibili, MissAV, and all yt-dlp supported sites
• GET /api/check-video-download - Check if a video has already been downloaded
  • Query params: url (required)
  • Returns: { found: boolean, status: 'exists' | 'deleted', videoId?: string, ... }
• GET /api/check-bilibili-parts - Check if a Bilibili video has multiple parts
  • Query params: url (required)
• GET /api/check-bilibili-collection - Check if a Bilibili URL is a collection/series
  • Query params: url (required)
• GET /api/download-status - Get status of active downloads
  • Returns: { active: [], queued: [] }

Video Management

• POST /api/upload - Upload a local video file
  • Multipart form data: video (file)
  • Automatically generates thumbnail
• GET /api/videos - Get all downloaded videos
  • Query params: page (optional), limit (optional), sortBy (optional), order (optional), search (optional), author (optional), tags (optional)
• GET /api/videos/:id - Get a specific video by ID
• PUT /api/videos/:id - Update video details
  • Body: { title?, author?, tags?, rating?, ... }
• DELETE /api/videos/:id - Delete a video and its files
• GET /api/videos/:id/comments - Get video comments (if available)
• POST /api/videos/:id/rate - Rate a video (1-5 stars)
  • Body: { rating: number }
• POST /api/videos/:id/refresh-thumbnail - Refresh video thumbnail
• POST /api/videos/:id/view - Increment view count
• PUT /api/videos/:id/progress - Update playback progress
  • Body: { progress: number } (seconds)

Download Management

• POST /api/downloads/cancel/:id - Cancel an active download
• DELETE /api/downloads/queue/:id - Remove a download from queue
• DELETE /api/downloads/queue - Clear entire download queue
• GET /api/downloads/history - Get download history
  • Query params: page (optional), limit (optional)
• DELETE /api/downloads/history/:id - Remove an item from download history
• DELETE /api/downloads/history - Clear entire download history

Collections

• GET /api/collections - Get all collections
• POST /api/collections - Create a new collection
  • Body: { name: string, videoIds?: string[] }
• PUT /api/collections/:id - Update a collection (add/remove videos)
  • Body: { name?: string, videoIds?: string[], action?: 'add' | 'remove' }
• DELETE /api/collections/:id - Delete a collection

Subscriptions

• GET /api/subscriptions - Get all subscriptions
• POST /api/subscriptions - Create a new subscription
  • Body: { authorUrl: string, interval: number, platform?: string }
  • interval: Check interval in minutes
  • platform: 'YouTube' (default) or 'Bilibili'
• DELETE /api/subscriptions/:id - Delete a subscription

Settings & System

• GET /api/settings - Get application settings
• POST /api/settings - Update application settings
  • Body: { [key: string]: any } - Settings object
• GET /api/settings/password-enabled - Check if password protection is enabled
• POST /api/settings/verify-password - Verify login password
  • Body: { password: string }
• POST /api/settings/reset-password - Reset login password
  • Body: { oldPassword: string, newPassword: string }
• POST /api/settings/migrate - Migrate data from JSON to SQLite
• POST /api/settings/delete-legacy - Delete legacy JSON data files
• POST /api/settings/format-filenames - Format video filenames according to settings
• POST /api/settings/upload-cookies - Upload cookies.txt for yt-dlp
  • Multipart form data: file (cookies.txt)
• POST /api/settings/delete-cookies - Delete cookies.txt
• GET /api/settings/check-cookies - Check if cookies.txt exists

File Management

• POST /api/scan-files - Scan for existing video files in uploads directory
• POST /api/cleanup-temp-files - Cleanup temporary download files