CoolFace
Apppublic

devkevo/arrow-md-media-api

sourceHugging Faceupdated 5mo agoView on Hugging Face
0likes
App README

Arrow MD Media API 🚀

yt-dlp powered media downloader API designed for the Arrow MD WhatsApp Bot.

This FastAPI backend allows you to download videos, audio (MP3/AAC), images, GIFs, and thumbnails from YouTube, TikTok, Instagram, Facebook, Twitter/X, and many other platforms — then automatically uploads them to Catbox.moe for easy sharing.

✨ Features

  • —High-quality downloads with multiple quality options (best, medium, low)
  • —Platform-specific optimizations (TikTok, Instagram, etc.)
  • —Audio extraction (MP3 or AAC)
  • —GIF conversion (with length limit)
  • —Thumbnail / Image download
  • —Auto platform detection
  • —Multi-URL download (batch up to 10)
  • —Format listing — choose exact format before downloading
  • —In-memory caching (1 hour TTL)
  • —Concurrent download limiting (max 3 heavy downloads)
  • —WhatsApp-friendly size checks (64MB video, 5MB image, etc.)
  • —Protected endpoints with simple API key authentication

🛠️ Endpoints Overview

MethodEndpointDescription
GET/API info & available endpoints
GET/healthHealth check + yt-dlp version
POST/infoGet media metadata
POST/formatsList all available download formats
POST/download/videoDownload video
POST/download/audio or /mp3Download as MP3
POST/download/audio/aacDownload as AAC
POST/download/gifDownload as GIF (max 15s)
POST/download/imageDownload thumbnail as image
POST/download/autoAuto-detect platform
POST/download/tiktokTikTok-specific
POST/download/instagramInstagram-specific
POST/download/facebookFacebook / fb.watch
POST/download/twitterTwitter / X
POST/download/youtubeYouTube
POST/download/multiBatch download multiple URLs

All protected endpoints require the header: