XVIDEOS API

Disclaimer

[!IMPORTANT] This is an unofficial and unaffiliated project. Please read the full disclaimer before use: DISCLAIMER.md

By using this project you agree to comply with the target site’s rules, copyright/licensing requirements, and applicable laws. Do not use it to bypass access controls or scrape at disruptive rates.

Features

Fetch videos + metadata
Download videos
Fetch Channels
Fetch Pornstars
Search for videos
Fetch playlists
Account login (Fetch Liked, watched and recommended videos)
Asynchronous
Built-in caching
Easy interface
Great type hinting

Networking Features

HTTP 2.0 / HTTP 3.0
Browser impersonation
Custom JA3
All proxy types
Proxy authentication
Speed Limit
DNS over HTTPS
And even more...
All of this is configurable and can be adjusted as you like!

Supported Platforms

This API has been tested and confirmed working on:

Windows 11 (x64)
macOS Sequoia (x86_64)
Linux (Arch) (x86_64)
Android 16 (aarch64)

Quickstart

Have a look at the Documentation for more details

Install the library with pip install xvideos_api

import asyncio
from xvideos_api import Client
# Initialize a Client object

async def do_something():    
    client = Client()
    
    # Fetch a video
    video_object = await client.get_video("<insert_url_here>")
    
    # Information from Video objects
    print(video_object.title)
    print(video_object.likes)
    # Download the video
    
    await video_object.download(downloader="threaded", quality="best", path="your_output_path + filename")

asyncio.run(do_something())    
# SEE DOCUMENTATION FOR MORE

[!NOTE] XVideos API can also be used from the command line. Do: xvideos_api -h to see the options

Changelog

See Changelog for more details.

Support (Donations)

I am developing all my projects entirely for free. I do that because I have fun and I don't want to charge 30€ like other people do.

However, if you find my work useful, please consider donating something. A tiny amount such as 1€ means a lot to me.

Paypal: https://paypal.me/EchterAlsFake
XMR (Monero): 42XwGZYbSxpMvhn9eeP4DwMwZV91tQgAm3UQr6Zwb2wzBf5HcuZCHrsVxa4aV2jhP4gLHsWWELxSoNjfnkt4rMfDDwXy9jR

Contribution

Do you see any issues or having some feature requests? Simply open an Issue or talk in the discussions.

Pull requests are also welcome.

License

Licensed under the LGPLv3 License
Copyright (C) 2023–2026 Johannes Habel

Metadata

Release files for xvideos_api 2.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xvideos_api 2.2.2
File	Size	Uploaded
xvideos_api-2.2.2.tar.gz	14.3 kB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for xvideos_api 2.2.2
File	Interpreter	ABI	Platform	Reset
xvideos_api-2.2.2-py3-none-any.whl 19.1 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 33.3 kB

Release files / xvideos_api-2.2.2.tar.gz

Download URL	xvideos_api-2.2.2.tar.gz
Size	14.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`a0253f7801f3f830260fc42b7273c59363d3a250a4024990e71ea388540df577`
BLAKE2b-256 checksum How to use checksums	`0a3872a071b282959528ed333e0d21228e1d155c59b6d1ed99f3caf6345b7b34`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / xvideos_api-2.2.2-py3-none-any.whl

Download URL	xvideos_api-2.2.2-py3-none-any.whl
Size	19.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`08902bf44678bf63df3e259d4c8686133cfc124930711f91d5eee44716012014`
BLAKE2b-256 checksum How to use checksums	`5a312eb507b0f71ca21c08db6c13743571fedac165361db589187534828cfc22`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`