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.
- Fetch videos + metadata
- Download videos
- Fetch Pornstars
- Search for videos
- Get videos by category
- Other site specific features
- Built-in caching
- Easy interface
- Great type hinting
- Proxy support
- Very customizable
This API has been tested and confirmed working on:
- Windows 11 (x64)
- macOS Sequoia (x86_64)
- Linux (Arch) (x86_64)
- Android 16 (aarch64)
Have a look at the Documentation for more details
- Install the library with
pip install hqporner_api
from hqporner_api import Client
# Initialize a Client object
client = Client()
# Fetch a video
video_object = client.get_video("<insert_url_here>")
# Can also be a mobile URL e.g., https://m.hqporner.com/<video>
# Download the video
video_object.download(quality="best", path="your_output_path + title.mp4")
# Videos by actress
actress_generator = client.get_videos_by_actress("anissa-kate")
for video in actress_generator:
print(video.title) # etc...
# Search for videos
videos = client.search_videos(query="Your query here")
for video in videos:
print(video.title)
# SEE DOCUMENTATION FOR MORENote
HQPorner API can also be used from the command line. Do: hqporner_api -h to see the options
See Changelog for more details.
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
Do you see any issues or having some feature requests? Simply open an Issue or talk in the discussions.
Pull requests are welcome :)
Licensed under the LGPLv3 License
Copyright (C) 2023–2026 Johannes Habel