HQPorner API

Disclaimer

[!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.

Features

Asynchronous
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

Networking Features

HTTP 2.0 / HTTP 3.0
Browser impersonation
Custom JA3
All proxy types
Proxy authentication
Speed Limit
DNS over HTTPS
And even more...
All of this is configurable and can be adjusted as you like!

Supported Platforms

This API has been tested and confirmed working on:

Windows 11 (x64)
macOS Sequoia (x86_64)
Linux (Arch) (x86_64)
Android 16 (aarch64)

Quickstart

Have a look at the Documentation for more details

Install the library with pip install hqporner_api

import asyncio
from hqporner_api import Client
# Initialize a Client object

async def do_something():    
    client = Client()
    
    # Fetch a video
    video_object = await client.get_video("<insert_url_here>")
    # Can also be a mobile URL e.g., https://m.hqporner.com/<video>
    
    # Download the video
    await video_object.download(quality="best", path="your_output_path + title.mp4")
    
    # Videos by actress
    actress_generator = client.get_videos_by_actress("anissa-kate")
    async for video in actress_generator:
        print(video.title) # etc...
    
    # Search for videos
    videos = client.search_videos(query="Your query here")
    async for video in videos:
        print(video.title)

asyncio.run(do_something())
        
        
# 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): 42XwGZYbSxpMvhn9eeP4DwMwZV91tQgAm3UQr6Zwb2wzBf5HcuZCHrsVxa4aV2jhP4gLHsWWELxSoNjfnkt4rMfDDwXy9jR

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

Metadata

Release files for hqporner_api 2.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hqporner_api 2.1.1
File	Size	Uploaded
hqporner_api-2.1.1.tar.gz	13.5 kB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hqporner_api 2.1.1
File	Interpreter	ABI	Platform	Reset
hqporner_api-2.1.1-py3-none-any.whl 17.5 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 31.0 kB

Release files / hqporner_api-2.1.1.tar.gz

Download URL	hqporner_api-2.1.1.tar.gz
Size	13.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`28db4e002a7cadf73ec81982c7f82621eb7f1367ef837479e0e93c84a7e90c03`
BLAKE2b-256 checksum How to use checksums	`845e3f35470794f0fb63db3e2e06c79b9e26ffccd8cd5db6fa6b66a49d7ccde6`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","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}`

Release files / hqporner_api-2.1.1-py3-none-any.whl

Download URL	hqporner_api-2.1.1-py3-none-any.whl
Size	17.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`22e5613fc5edbb98fe1302e0975f938c8a0fbe5b9f17ae557d9dec8da5864e7d`
BLAKE2b-256 checksum How to use checksums	`7c9bc2554357e33356e77cf4f2e2bee41f48224a9081030703bd9437b9393e35`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","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}`