TunelioTwo endpoints · no polling · direct download URLs
A YouTube download API
built for builders, not browsers.
Two endpoints. Paste a URL, get back a direct download link — no queueing, no polling, no progress webhook. MP4 up to 4K, MP3 at 320kbps.
tunelio.dev
live
$ curl "https://tunelio.dev/create?quality=720p&url=…" \ -H "Authorization: Bearer tnl_…" { "url": "…/tunnel?id=…&sig=…", "file_size_str": "28.52 MB", "status": "tunnel" }
← response in ~400ms · ready to download
How it works
Two calls. No waiting.
Most "download API"s queue your job and make you poll for progress. We just give you the link. Same request, same response.
016 credits
GET /info
Send any YouTube URL. We return metadata, all available video qualities, and audio formats — in under a second.
0210 credits
GET /create
Pick a quality, hit /create with the URL. The download link comes back in the same response.
03free
Download directly
Pipe the returned tunnel URL straight to your user, S3, or transcoder. We stream from CDN — your server stays out of it.
What you won't find here
✗ No job queues✗ No status polling✗ No progress webhooks✗ No SSE streams
Developer API
Drop it into your stack today.
Two endpoints, one auth header. Copy-paste examples for the languages you actually use.
Instant download URLs
/create returns the link in the same response. No polling.
Telegram-first auth
No email signup. Generate a key with one tap in our bot.
Pay only for what you use
Monthly credits, fresh each cycle.
# 1. Get available formats
curl "https://tunelio.dev/info?url=https://youtu.be/dQw4w9WgXcQ" \
-H "Authorization: Bearer tnl_8f3a92…"
# 2. Get a direct download URL (returns instantly)
curl "https://tunelio.dev/create?quality=720p&url=https://youtu.be/dQw4w9WgXcQ" \
-H "Authorization: Bearer tnl_8f3a92…"Endpoints
The whole API. Two endpoints.
GET
6 credits/infoReturns title, duration, thumbnail, and every available video & audio format with file sizes.
Query params
urlstringrequired— Any YouTube watch / shorts / share URLResponse shape
{ title, duration_seconds, thumbnail, formats[], audioFormat }GET
10 credits/createReturns a signed, direct CDN download URL — in the same response. No polling, no progress webhook.
Query params
urlstringrequired— Any YouTube watch / shorts / share URLqualitystringrequired— e.g. 144p, 360p, 720p, 1080p, mp3Response shape
{ url, filename, quality, file_size_str, expires, status }The URL returned by /create points to tunelio.dev/tunnel — that's the file. You don't call it from your code; you hand it to your user or your downloader.
Capabilities
Only the bits you'll actually use.
Instant download URLs
/create gives you the link in the same response. Zero polling.
Every native quality
144p to 1080p out of the box. 4K available on Mega.
Audio-only MP3
Server-side transmux. Skip the ffmpeg setup.
Direct CDN delivery
Files stream from our CDN — your server never proxies the bytes.
Credit-based pricing
Predictable. 6 credits for /info, 10 for /create. No surprise bills.
Telegram-first auth
Sign up with a tap — no email, no password, no card.
Pricing
Pay by the call. No surprises.
One /info = 6 credits. One /create = 10 credits.
Monthly billing.
Free on signup
Trial
Try the API before paying anything.
$0/month
100 credits — one-time
15 requests / minute
Up to 720p MP4 + 320k MP3
Community support
Pro
$9/month
100,000 credits / month
No rate limit
Up to 1080p MP4 + MP3
Email support · 48h
Recommended
Ultra
$39/month
500,000 credits / month
No rate limit
Up to 1080p MP4 + MP3
Priority support · 24h
Mega
$99/month
1,500,000 credits / month
No rate limit
Up to 4K MP4 + MP3
Dedicated support · 4h
Need something custom?
Higher volume or dedicated infrastructure — we'll put together a plan that fits. Tell us what you need and we'll reply within one business day.
Built for
Telegram bots, websites, and mobile apps.
TG BOT
Telegram bots
Reply to a YouTube link with the downloaded file in seconds. /create gives you a direct URL that Telegram can fetch and re-upload as a file.
WEB
Websites
Embed a download box on your site. Pass the URL to /create from your backend, hand the response link to the browser — done.
MOBILE
Mobile apps
Offline-first video apps that let users save lectures or playlists for the plane. No queues, so your UI shows "downloading" instead of "waiting".
Tunelio is a generic content-resolution API. You are responsible for ensuring your downstream use complies with YouTube's ToS and your local copyright law. Most jurisdictions permit personal-use downloads and educational re-use.
Start free. Ship today.
100 credits on signup, no card. Open Telegram, get a key, and you'll be downloading inside a minute.