XNXX 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 Users
Search for 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 xnxx_api

import asyncio
from xnxx_api import Client

async def main():
    # Initialize a Client object
    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")

# SEE DOCUMENTATION FOR MORE

[!NOTE] XNXX API can also be used from the command line. Do: xnxx_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 xnxx_api 2.1

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

Source distribution (sdist)

Source distribution for xnxx_api 2.1
File	Size	Uploaded
xnxx_api-2.1.tar.gz	10.9 kB	Jun 23, 2026	Details

Built distribution (wheel)

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

Total release size: 25.6 kB

Release files / xnxx_api-2.1.tar.gz

Download URL	xnxx_api-2.1.tar.gz
Size	10.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`5ef7dd6b24a1a059ce687b0046773e42e05081a8c45a4dd42301adf067f7aa7c`
BLAKE2b-256 checksum How to use checksums	`1335064b504e22e621d4bdd039f6685167b1a39e1bf99b64130459ce3c48f524`
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 / xnxx_api-2.1-py3-none-any.whl

Download URL	xnxx_api-2.1-py3-none-any.whl
Size	14.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`22bbd34f00c0b93c143d88ed698cc55586a597317887c644e79127c2baf1d6d3`
BLAKE2b-256 checksum How to use checksums	`15dfa9526b99316ad1f33578b711f40f949e0eaba1f38c1f7e9315870c606e9f`
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}`