pip install -U saverapi-client            # sync client + CLI
pip install -U "saverapi-client[async]"   # + AsyncSaverAPI (httpx)

Get a free API key at saverapi.net — no card needed.

Quick start

from saverapi import SaverAPI

api = SaverAPI(api_key="YOUR_API_KEY")   # or export SAVERAPI_KEY=...

media = api.download("https://www.instagram.com/reel/DPOi9V-CAqH/")
print(media["hosting"], media["type"], media["download_url"])

api.save_file(media["download_url"], "downloads/reel.mp4")

One call, one parameter: the All-in-One downloader recognises the platform from the link. The response's hosting field tells you which network it was, type is video or image, and download_url points at the file.

Supported platforms

Full parameter reference and response samples: saverapi.net/docs. Endpoints added to the catalog later can be called with api.request("/endpoint-path", {"param": "value"}).

Examples

Download a YouTube video or MP3

video = api.youtube("https://youtu.be/OORSiK8ScTI", format="720")   # 1080|720|480|360|240|144|mp3
api.save_file(video["url"], "video.mp4")

info = api.youtube_info("https://youtu.be/OORSiK8ScTI")
print(info["title"], info["duration"])

Download TikTok, Facebook or X videos

for link in [
    "https://www.tiktok.com/@user/video/7300000000000000000",
    "https://www.facebook.com/watch/?v=1234567890",
    "https://x.com/user/status/1234567890",
]:
    media = api.download(link)
    print(media["hosting"], media["download_url"])

Instagram profile

profile = api.instagram_profile("cristiano")
print(profile["user"]["full_name"], profile["user"]["is_verified"])

Recognise a song, search music, read charts

song = api.shazam_recognize("https://example.com/clip.mp3")
print(song["track"]["title"], "—", song["track"]["subtitle"])

results = api.music_search("Hello Adele", limit=5)
top = api.shazam_top("united-states")

Check your plan and credits (free)

print(api.info_balance())

Async (aiogram, FastAPI, asyncio)

import asyncio
from saverapi import AsyncSaverAPI

async def main():
    async with AsyncSaverAPI() as api:   # reads SAVERAPI_KEY
        results = await asyncio.gather(
            api.download("https://www.instagram.com/reel/DPOi9V-CAqH/"),
            api.youtube_info("https://youtu.be/OORSiK8ScTI"),
        )
        print(results)

asyncio.run(main())

Telegram downloader bot (aiogram 3)

from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from saverapi import AsyncSaverAPI, SaverAPIError

bot = Bot("TELEGRAM_BOT_TOKEN")
dp = Dispatcher()
api = AsyncSaverAPI()   # SAVERAPI_KEY from the environment

@dp.message(F.text.startswith("http"))
async def on_link(message: Message):
    try:
        media = await api.download(message.text.strip())
    except SaverAPIError as exc:
        await message.answer(f"Could not download: {exc.message}")
        return
    if media.get("type") == "image":
        await message.answer_photo(media["download_url"])
    else:
        await message.answer_video(media["download_url"])

dp.run_polling(bot)

Step-by-step guide: Build a Telegram video downloader bot.

Command line

export SAVERAPI_KEY=your_key
saverapi download https://www.instagram.com/reel/DPOi9V-CAqH/
saverapi youtube https://youtu.be/OORSiK8ScTI --format mp3
saverapi youtube-info https://youtu.be/OORSiK8ScTI
saverapi instagram cristiano
saverapi shazam https://example.com/clip.mp3
saverapi balance

Prints the JSON response; exits with status 1 on an API error.

Errors and retries

Rate limits (429) and temporary server errors (5xx) are retried automatically with exponential backoff (max_retries=2 by default). Failed 5xx calls are not charged. Everything else raises a specific exception:

from saverapi import (
    SaverAPIError, AuthenticationError, InsufficientCreditsError,
    RateLimitError, NotFoundError, ServerError, NetworkError,
)

try:
    api.download(link)
except AuthenticationError:        # 401/403 — wrong or disabled key
    ...
except InsufficientCreditsError:   # 402 — top up or upgrade at saverapi.net/pricing
    ...
except RateLimitError as exc:      # 429 after retries
    ...
except SaverAPIError as exc:       # anything else; exc.status_code, exc.message, exc.payload
    ...

Options: SaverAPI(api_key=None, timeout=60, base_url=None, session=None, max_retries=2, backoff=1.0). Use it as a context manager (with SaverAPI() as api:) to close the HTTP session.

Tips

• Media links (download_url) come from the networks' CDNs and expire — download them right after the call.
• Only public content can be resolved; private accounts and deleted posts fail.
• Keep the API key on your server; mobile and web apps should call your backend.
• Respect each platform's terms of service and creators' rights.

Links

• Website and free API key: https://saverapi.net
• API documentation: https://saverapi.net/docs
• YouTube Downloader API: https://saverapi.net/youtube-downloader-api
• Instagram Downloader API: https://saverapi.net/instagram-downloader-api
• TikTok Downloader API: https://saverapi.net/tiktok-downloader-api
• All-in-One Downloader API: https://saverapi.net/all-in-one-downloader-api
• Tutorials: https://saverapi.net/blog
• Pricing: https://saverapi.net/pricing
• Telegram: https://t.me/SaverAPI

Changelog

1.1.0

• New methods covering the whole catalog: youtube_telegram, youtube_info_basic, youtube_subtitles, instagram_profile, photolab, and request() for any endpoint.
• AsyncSaverAPI for asyncio (pip install "saverapi-client[async]").
• saverapi command line tool.
• Automatic retries with backoff for 429 and 5xx; specific exception classes.
• API key from the SAVERAPI_KEY environment variable; context-manager support; type hints (py.typed).
• Fully backwards compatible with 1.0.x.

License

MIT © SaverAPI.NET