Skip to main content

A Python API for the Porn Site xnxx.com

Project description

XNXX API

Downloads CodeQL Analysis API Tests

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
  • Built-in caching
  • Easy interface
  • Great type hinting
  • Proxy support
  • Very customizable

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
from xnxx_api import Client
# Initialize a Client object
client = Client()

# Fetch a video
video_object = client.get_video("<insert_url_here>")

# Information from Video objects
print(video_object.title)
print(video_object.likes)
# Download the video

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–2025 Johannes Habel

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xnxx_api-1.6.3.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xnxx_api-1.6.3-py3-none-any.whl (13.6 kB view details)

Uploaded Python 3

File details

Details for the file xnxx_api-1.6.3.tar.gz.

File metadata

  • Download URL: xnxx_api-1.6.3.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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}

File hashes

Hashes for xnxx_api-1.6.3.tar.gz
Algorithm Hash digest
SHA256 4590da82cdddce8297b536ce8db2a59908889f82cd8c2f3d9c04adcdbf7a07f1
MD5 497407e4045832172f89f13f608fdf91
BLAKE2b-256 3070e82fd7704afb965e97c2b59f7f217a106bf49027c1b37ffdff42c1a042ad

See more details on using hashes here.

File details

Details for the file xnxx_api-1.6.3-py3-none-any.whl.

File metadata

  • Download URL: xnxx_api-1.6.3-py3-none-any.whl
  • Upload date:
  • Size: 13.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","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}

File hashes

Hashes for xnxx_api-1.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 618f723e26d4dd2c0ae5837d5a4bf05abac1846fb4cd70bada30a9625a547877
MD5 7994cf0706450906bc47e9efb9493730
BLAKE2b-256 3a82c2b8fccd13c92ac213a223ffd918f087f7d335a7c30a36bb91902f54447c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page