Skip to main content

A Python API for the Porn Site xvideos.com

Project description

XVIDEOS API

Downloads Downloads (Async) CodeQL Analysis Sync API Tests Async Branch API Tests

Description

XVideos API is an API for xvideos.com. It allows you to fetch information from videos using regexes and requests.

Disclaimer

[!IMPORTANT] XVideos API is in violation to the ToS of xvideos.com! If you are the website owner of xvideos.com, contact me at my E-Mail, and I'll take this repository immediately offline. EchterAlsFake@proton.me

Quickstart

Have a look at the Documentation for more details

  • Install the library with pip install xvideos_api
from xvideos_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] 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): 46xL2reuanxZgFxXBBaoagiEJK9c7bL7aiwKNR15neyX2wUsX2QVzkeRMVG2Cro44qLUNYvsP1BQa12KPbNat2ML41nyEeq

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

xvideos_api_async-1.5.3.1.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

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

xvideos_api_async-1.5.3.1-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file xvideos_api_async-1.5.3.1.tar.gz.

File metadata

  • Download URL: xvideos_api_async-1.5.3.1.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for xvideos_api_async-1.5.3.1.tar.gz
Algorithm Hash digest
SHA256 475f7fd802f7714a7f25ea9274bafe81b87e67194ec6fb3a8f9a933165ef40d3
MD5 7f69b5168aad8e81566b705136472f56
BLAKE2b-256 12bff10ca097ce74fb39cfd690e5de49c551072c2e11e56921969ff5e6eab966

See more details on using hashes here.

File details

Details for the file xvideos_api_async-1.5.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for xvideos_api_async-1.5.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ea165e5f7371d849fe76e3f4220167b03d2f1d4f2e70400b3940b6cdc405dcde
MD5 45aaaf54289c46709e024be1763f3b5a
BLAKE2b-256 8a1f29eb721ab6ded2ef53d8d577dba8fddbd4493da6877b312ff52d861e8410

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