youtubedlapi-server-infusiblecoder

A REST API server for video info, downloads, and streaming — powered by yt-dlp (nightly).

Requires Python >= 3.11. Uses uv for package management. The Docker image includes Deno + FFmpeg for JavaScript extractors and video merging.

Installation

pip install youtubedlapi-server-infusiblecoder

Or from source:

git clone https://github.com/syedusama5556/youtubedlapi-server-infusiblecoder
cd youtubedlapi-server-infusiblecoder
pip install uv
uv sync

Docker

docker build -t youtubedlapi .
docker run -p 9191:9191 youtubedlapi

Usage

uvicorn youtubedlapi_server_infusiblecoder.app:app --host 0.0.0.0 --port 9191

Or via the CLI:

youtubedlapi-server-infusiblecoder --host 0.0.0.0 --port 9191

Dependencies

The server auto-detects these at startup:

Install any missing deps with:

pip install curl-cffi yt-dlp-ejs brotli websockets pycryptodomex mutagen

API Endpoints

All responses are JSON unless noted.

Info

Download & Stream

Server

Example: Download & Stream Flow

# 1. Download a video
curl "http://localhost:9191/api/download?url=https://youtube.com/watch?v=..."
# → { "file_id": "abc123", "stream_url": "/api/stream/abc123", ... }

# 2. Stream it (open in browser or player)
curl "http://localhost:9191/api/stream/abc123" -o video.mp4

# 3. Or embed in a video tag / VLC
# vlc http://localhost:9191/api/stream/abc123

Sample Usage (Tested URLs)

All tested with the latest nightly yt-dlp.

# YouTube — info, formats, subtitles, audio, search
curl "http://localhost:9191/api/info?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&flatten=true"
curl "http://localhost:9191/api/formats?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"
curl "http://localhost:9191/api/subtitles?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"
curl "http://localhost:9191/api/audio?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"
curl "http://localhost:9191/api/search?q=never+gonna+give+you+up&limit=3"

# Vimeo
curl "http://localhost:9191/api/info?url=https://vimeo.com/76979871&flatten=true"

# TED
curl "http://localhost:9191/api/info?url=https://www.ted.com/talks/chloe_valdary_how_love_can_help_repair_social_inequality&flatten=true"

# Dailymotion (requires curl-cffi)
curl "http://localhost:9191/api/info?url=https://www.dailymotion.com/video/xal2ebm&flatten=true"

# Bilibili
curl "http://localhost:9191/api/bili?url=https://www.bilibili.com/video/BV1GJ411x7"

Handling Failed Sites

These are known limitations — no server-side fix possible:

Project Structure

src/
└── youtubedlapi_server_infusiblecoder/   # Python package
    ├── app.py         # FastAPI app with all endpoints
    ├── server.py      # CLI entry point
    ├── __init__.py
    ├── __main__.py
    └── version.py
deploy/              # Docker, K8s, GAE, Heroku configs
docs/                # Sphinx documentation
devscripts/          # Build & publish scripts
test/                # Tests

Development

uv sync --group dev
uv run pytest

License

Released to the public domain.