EchterAlsFake / xvideos_api

a Python API for xvideos.com
GNU Lesser General Public License v3.0
18 stars 4 forks source link
api bs4 downloader lxml python requests xvideos xvideos-api

XVIDEOS API

Downloads CodeQL Analysis 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

from xvideos_api import Client, Quality, threaded, default, FFMPEG
# 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=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.

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