Skip to main content

A Python API for the Porn Site xhamster.com

Project description

XHamster API

Downloads CodeQL Analysis Sync API Tests

Description

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

Disclaimer

[!IMPORTANT] XHamster API is in violation to the ToS of xhamster.com! If you are the website owner of xhamster.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 xhamster_api
from xhamster_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

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

xhamster_api-1.7.2.tar.gz (8.8 kB view details)

Uploaded Source

Built Distribution

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

xhamster_api-1.7.2-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file xhamster_api-1.7.2.tar.gz.

File metadata

  • Download URL: xhamster_api-1.7.2.tar.gz
  • Upload date:
  • Size: 8.8 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 xhamster_api-1.7.2.tar.gz
Algorithm Hash digest
SHA256 35020f92a1d7e3113e7707faefaed8b42eacbe278d8b65866f0ec633bc90fef1
MD5 a2b31f5df914d873840ce6c3d104711d
BLAKE2b-256 675bf5ad4292ecaa6a035ce6f435cd8b12bb0cde651db4406690db7e43b9f745

See more details on using hashes here.

File details

Details for the file xhamster_api-1.7.2-py3-none-any.whl.

File metadata

  • Download URL: xhamster_api-1.7.2-py3-none-any.whl
  • Upload date:
  • Size: 11.1 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 xhamster_api-1.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6ac1199a145d73a7134c2fb79122085ecb2a1607e9bd233dc2f7fba7025f2c32
MD5 d0927574bd460a515bd146783e6e7032
BLAKE2b-256 689b91196033bdef53497f351f6d35730af6dbb48181bc691e0e73b81440f332

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