xfreehd_api 1.1

A Python API for the Porn Site xvideos.com

XVIDEOS API

Description

xFreeHD API is an API for xfreehd.com. It allows you to fetch information from videos using web scraping.

Disclaimer

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

Features

• Fetch all information from videos
• Download videos in SD / HD quality without logging in
• Fetch images from albums
• Proxy support
• (See more in the documentation)

Quickstart

Have a look at the Documentation for more details

• Install the library with pip install xfreehd_api

from xfreehd_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(quality="hd", path="your_output_path + filename")

# SEE DOCUMENTATION FOR MORE

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) 2025-2026 Johannes Habel