YouTube to Telegram Uploader

YouTube to Telegram Uploader API endpoints

• GET/search

  search

  If `query` is a URL, returns full video metadata (same as `/video_info`). Otherwise, searches YouTube and returns a list of matching results. Results are **cached for 1 hour** — identical queries return instantly. Each result includes title, video ID, URL, thumbnail, channel info, duration, and view count.

• GET/youtube_video_stream

  youtube_video_stream

  Extracts a direct streaming URL from YouTube and returns a temporary playback link valid for **10 minutes**. The playback link (`/youtube_video_stream_play`) streams the file in real time. If video and audio are separate tracks, they are merged on-the-fly. **Cookies**: Send your YouTube account cookies via the `X-Cookies` header to access private videos, personal playlists, or members-only content.

• GET/youtube_live_hls

  youtube_live_hls

  Validates that the video is currently live, then returns a temporary playback link valid for **10 minutes**. The playback link (`/youtube_live_hls_play`) delivers the stream as **segmented chunks** with adaptive bitrate — ideal for web players and most streaming clients. **Adaptive vs MP4**: Use this endpoint for web players and modern streaming clients. Use `/youtube_live_mp4` when you need a format compatible with standard media players that don't support adaptive streaming. Use `audio_only=true` to receive an audio-only stream. **Cookies**: Send your YouTube account cookies via the `X-Cookies` header to access private videos, personal playlists, or members-only content.

• GET/youtube_to_telegram

  youtube_to_telegram

  Downloads a YouTube video or audio track and uploads it to a Telegram channel. **Caching**: All formats and qualities are cached — subsequent requests for the same video, format, and quality return instantly. **Webhook**: Supply `webhook_url` to receive a POST notification when the upload completes. The payload will be: ```json {"job_id": "abc123", "status": "completed", "video_id": "dQw4w9WgXcQ", "result": {...}, "timestamp": 1700000000.0} ``` **Cookies**: Send your YouTube account cookies via the `X-Cookies` header to access private videos, personal playlists, or members-only content.

• GET/youtube_to_server

  youtube_to_server

  Downloads a YouTube video or audio track to the server and returns a temporary download link valid for **10 minutes**. **MEGA subscribers** have no file size limit; others are limited to 5 GB. **Webhook**: Supply `webhook_url` to receive a POST callback when the download completes. The payload will be: ```json {"job_id": "abc123", "status": "completed", "video_id": "dQw4w9WgXcQ", "result": {...}, "timestamp": 1700000000.0} ``` **Cookies**: Send your YouTube account cookies via the `X-Cookies` header to access private videos, personal playlists, or members-only content.

• GET/video_info

  video_info

  Fetches metadata for any supported video URL (YouTube, TikTok, Instagram, Facebook, SoundCloud, and more), including title, duration, view count, thumbnail, subtitles, available formats, and uploader info. Results are **cached for 1 hour** — subsequent requests for the same URL return instantly. Requests with cookies bypass the cache. **Cookies**: Send your account cookies via the `X-Cookies` header to access private content.