Developer API

Integration Protocol

Rojger Downloader is powered by a robust, asynchronous Python FastAPI backend. While our primary interface is the sleek web application, the underlying liquid engine is designed to be highly modular and capable of handling massive throughput. Developers looking to integrate our universal media extraction capabilities into their own applications can do so by interacting directly with our endpoints.

Endpoint: POST /api/info

This endpoint expects a JSON payload containing the `url` of the target media. It rapidly parses the URL, determines the optimal extraction strategy (switching intelligently between our Cobalt API integration for IP-blocked platforms like Instagram and TikTok, and our advanced yt-dlp subsystem for YouTube and 1000+ other sites), and returns a comprehensive metadata object. This includes the video title, duration, high-resolution thumbnail, author information, and an array of available formats ranging from 144p up to 8K resolution.

Endpoint: GET /api/download

This is the core of the Rojger proxy engine. By passing the `url` and the desired `format_id` as query parameters, this endpoint initiates the download. If a direct HTTPS stream is available, it responds with an optimized proxy stream to force a direct file download while masking the IP. If the stream requires DASH/HLS merging, it spawns an isolated ffmpeg process that pipes the fragmented MP4 stream directly to the client's browser in real-time. This guarantees zero disk usage on the server while delivering maximum bandwidth to the user.

Please note that the API is currently protected by rate-limiting middleware (SlowAPI) to prevent abuse and ensure high availability for all users. Custom API keys and elevated rate limits for enterprise partners will be available in the upcoming V5.0 release.