HQPorner API

(Async)

Description

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

Disclaimer

Important

HQPorner API is in violation to HQporner's ToS! If you are the website owner of hqporner.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 hqporner_api

from hqporner_api import Client
# Initialize a Client object
client = Client()

# Fetch a video
video_object = client.get_video("<insert_url_here>")

# 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 MORE

Note

HQPorner API can also be used from the command line. Do: hqporner_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 welcome :)

License

Licensed under the LGPLv3 License
Copyright (C) 2023–2025 Johannes Habel