@datapeice

tizrok

telegram media downloader bot & music search api

media downloader bot (@tizrokbot) and audio search API. extracts audio (320kbps MP3), youtube videos with multi-language audio track selection, tiktok slideshows, instagram, and reddit media up to 2GB.

BOT COMMANDS & USAGE TRACKING

users can manage their API keys and monitor individual traffic consumption directly inside the bot:

Command Function
/buygb Purchase extra download bandwidth for bot users using Telegram Stars.
/buyapi Purchase or top up developer REST API traffic (default 1 GB at 50 Stars).
/myapi View your personal API key, used GBs, remaining quota, and request count.
/traffic Check personal bot bandwidth consumption (isolated per-user counter).
/settings Configure description output format for downloaded media.

quota alerts: when your bandwidth limit approaches exhaustion, the bot automatically sends a notification so you can top up GBs without interruption.

DEVELOPER API & PRICING

self-service REST API access for external bots and apps. pay as you go via Telegram Stars:

50 Telegram Stars / GB self-service top-up via /buyapi in @tizrokbot (default: 1 GB)
Method Endpoint Output
GET|POST /api/v1/download Audio binary stream (audio/mpeg) — song search or direct audio link
GET|POST /api/v1/download/video Video stream (video/mp4) or ZIP archive for albums/slideshows
GET|POST /api/v1/links/extract JSON link parser and platform classification
GET /api/v1/health Service health status
Authentication via header (X-API-Key) or query parameter:
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.tizrok.dev/api/v1/download?query=song+title" \
  -o track.mp3

TRAFFIC LIMITS & PLANS

Tier Monthly Quota Cost Access Method
Bot Standard & Bot Premium 50 GB / month Free Telegram UI (@tizrokbot)
Bot Extra Traffic 50 GB + Extra GBs Telegram Stars Telegram UI (/buygb)
Developer API Pay as you go 50 Stars / GB REST API (/buyapi)

the 50 GB monthly limit applies to all bot users, including Bot Premium. once exhausted, additional gigabytes must be purchased via /buygb using Telegram Stars.

HOW TO GET AN API KEY

  1. Open @tizrokbot on Telegram and send /buyapi (default: 1 GB for 50 Stars).
  2. Pay with Telegram Stars to instantly activate your API key.
  3. Run /myapi to view your key and track real-time traffic statistics.