TNAFlix API

pip install unofficial-api-for-tnaflix

import asyncio
from tnaflix_api import Client
from base_api import DownloadConfigRAW

async def main():
    client = Client()

    # Fetch a video
    video = await client.get_video("https://www.tnaflix.com/hd-videos/example-video-12345")

    # Print metadata
    print(f"Title: {video.title}")
    print(f"Duration: {video.length} ({video.duration}s)")
    print(f"Available Qualities: {video.video_qualities}")

    # Download video using progressive MP4 downloader
    config = DownloadConfigRAW(quality="best", path="./downloads")
    success = await video.download(configuration=config)
    print(f"Download complete: {success}")

asyncio.run(main())

from base_api import BaseCore
from base_api.modules.config import RuntimeConfig
from tnaflix_api import Client

config = RuntimeConfig()
config.proxy = "socks5://127.0.0.1:9050"
config.request_attempts = 3

core = BaseCore(configuration=config)
client = Client(core=core)

from base_api import ErrorAction, ErrorMode, ResultOrder, RetryPolicy, ScrapeErrorContext
from base_api.modules.config import IteratorConfig

async def handle_scrape_error(context: ScrapeErrorContext) -> ErrorAction:
    print(context.stage, context.url, context.error, context.attempt)
    return ErrorAction.RETRY

retry = RetryPolicy(max_attempts=3, base_delay=0.5, multiplier=2, max_delay=8)
iterator_config = IteratorConfig(
    max_page_concurrency=2,
    max_item_concurrency=5,
    order=ResultOrder.ORIGINAL,
    load_specific_sources=("html",),
    page_retry=retry,
    item_retry=retry,
    page_error_mode=ErrorMode.SKIP,
    item_error_mode=ErrorMode.YIELD,
    page_error_handler=handle_scrape_error,
    item_error_handler=handle_scrape_error,
)

async for result in client.search("college", iterator_config=iterator_config):
    print(result.unwrap().title if result.succeeded else result.error)

from tnaflix_api import Client
from base_api import BaseCore

client = Client()
client_custom = Client(core=BaseCore())

from tnaflix_api import Client
from tnaflix_api.modules.sorting import Sort, SortDate

client = Client()

# Search for top-rated videos from the past month
async for result in client.search(
    query="blonde",
    sorting_sort=Sort.TOP_RATED,
    sorting_date=SortDate.THIS_MONTH,
    pages=3
):
    if result.succeeded:
        video = result.unwrap()
        print(video.title, video.url, video.length)
    else:
        print(f"Error: {result.error}")

from base_api import DownloadConfigRAW

config = DownloadConfigRAW(
    quality="best",            # "best", "half", "worst", or height int (e.g. 720, 1080)
    path="./downloads",        # Destination directory or file path
    no_title=False,            # If False, automatically appends video title + ".mp4"
    allow_multipart=True,      # Enable multi-threaded byte-range chunk downloading
    max_workers=5              # Concurrent download workers
)

success = await video.download(configuration=config)

async for result in client.search("college", pages=2):
    if result.succeeded:
        video = result.unwrap()
        print(f"Found: {video.title}")
    else:
        print(f"Stage {result.stage} error: {result.error}")

from base_api import MediaLoadError
from tnaflix_api.modules.errors import NotFound, BotDetection

try:
    video = await client.get_video(url)
except MediaLoadError as error:
    if isinstance(error.original_error, NotFound):
        print("This video does not exist!")
    elif isinstance(error.original_error, BotDetection):
        print("Scraper was blocked by anti-bot measures.")
    else:
        raise

tnaflix_api --download "https://www.tnaflix.com/hd-videos/example-video-12345" --quality best --output ./downloads

python -m tnaflix_api --download "https://www.tnaflix.com/hd-videos/example-video-12345" --quality 720 --output ./downloads

tnaflix_api --file urls.txt --quality best --output ./downloads --no-title False