vidara-api

A professional, type-hinted Python wrapper for the Vidara video hosting API.

Unofficial. Not affiliated with Vidara. Works against https://api.vidara.so/v1.

Features

• ✅ Sync client built on requests
• ✅ Async client on httpx (vidara-api[async])
• ✅ Fully typed dataclass models + py.typed (PEP 561)
• ✅ Clear exceptions for auth, not-found, server errors
• ✅ Covers every documented endpoint: account, upload, video/file, folders
• ✅ Zero-config; just your API key

Installation

pip install vidara-api            # sync only
pip install vidara-api[async]     # with async support

Quickstart

from vidara import VidaraClient

# Grab your API key at https://vidara.to/settings
client = VidaraClient("YOUR_API_KEY")

# Account info
me = client.get_account_info()
print(me.username, me.videos_total)

# Upload a video from a URL
video = client.upload_from_url("https://example.com/video.mp4")
print(video.filecode, video.title)

# List your videos
videos = client.list_videos(limit=50)
for v in videos.videos:
    print(v.title, v.link)

# Rename a video
client.rename_video(video.filecode, "My New Title")

# Move to a folder
client.move_video(video.filecode, folder_id=5)

Async usage

import asyncio
from vidara import AsyncVidaraClient

async def main():
    client = AsyncVidaraClient("YOUR_API_KEY")
    me = await client.get_account_info()
    print(me.username)

asyncio.run(main())

Endpoints

Error handling

All API errors raise a VidaraAPIError (or a subclass):

• AuthenticationError — invalid/forbidden API key (403)
• NotFoundError — resource missing (404)
• ServerError — server failure (5xx)
• BadRequestError — bad input
• EncodingError — video still encoding
• RateLimitError — too many requests

from vidara import VidaraClient, VidaraAPIError

client = VidaraClient("bad_key")
try:
    client.get_account_info()
except VidaraAPIError as e:
    print(e)  # access denied

Development

pip install -e .[dev]
pytest

License

MIT © 2026 0xKatso