An asynchronous Python API wrapper and scraper for hqporner.com
+
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.
| Category | Details |
|---|---|
| Video Fetching | Fetch video objects with full metadata (title, views, quality, publish date, duration) |
| Video Downloading | RAW/direct-based downloading with quality selection |
| Actress Videos | Fetch videos uploaded by or featuring specific actresses |
| Category Search | Get videos by specific categories |
| Video Search | Search videos using query strings with support for pagination |
| Top Porn / Random | Fetch top sorted videos (by views, rating, date) or retrieve a completely random video |
| Brazzers videos | Fetch and parse Brazzers content |
| Async-First | Fully asynchronous (async / await) built on top of asyncio |
| Built-in Caching | Automatic response caching with configurable limits to reduce redundant network requests |
| CLI Support | Command-line interface for quick downloads — run hqporner_api -h for options |
| Type Safety | Comprehensive type hinting and dataclass-based models throughout |
The networking layer is provided by the eaf_base_api package and is fully configurable through RuntimeConfig:
| Feature | Description |
|---|---|
| HTTP/1.1, HTTP/2, HTTP/3 | Configurable HTTP version (v1, v2, v3 — defaults to HTTP/3) |
| Browser Impersonation | Built-in browser fingerprint impersonation via curl_cffi (defaults to Chrome) |
| Custom JA3 Fingerprint | Override the TLS fingerprint with a custom JA3 string for advanced use cases |
| Proxy Support | All proxy types supported (HTTP, HTTPS, SOCKS4, SOCKS5) |
| Proxy Authentication | Username/password authentication for proxies |
| Bandwidth Limiting | Set a maximum download speed in MB/s (e.g., 2.0, 3.5) |
| DNS over HTTPS | Route DNS queries over HTTPS for privacy and bypassing DNS-level blocks |
| SSL Verification | Toggle SSL certificate verification on or off |
| Request Delay | Configurable delay between requests to respect rate limits |
| Concurrency Control | Tune video and page concurrency independently for optimal throughput |
This API has been tested and confirmed working on:
- Windows 11 (x64)
- macOS Sequoia (x86_64)
- Linux (Arch) (x86_64)
- Android 16 (aarch64)
pip install unofficial-api-for-hqpornerHave a look at the Documentation for more details
Note
HQPorner API can also be used from the command line. Do: hqporner_api -h to see the options
import asyncio
from hqporner_api import Client, DownloadConfigRAW
async def main():
# Initialize a Client object
client = Client()
# Fetch a video
video_object = await client.get_video("<insert_url_here>")
# Information from Video objects
print(video_object.title)
# Download the video
config = DownloadConfigRAW(quality="best", path="./") # More options in the documentation
await video_object.download(config)
if __name__ == "__main__":
asyncio.run(main())I develop all my projects entirely for free because I enjoy it and want to keep them accessible. If you find my work useful, please consider supporting me with a small donation — even 1 € makes a big difference and keeps me motivated!
https://ko-fi.com/EchterAlsFake
https://paypal.me/EchterAlsFake
Do you see any issues or having some feature requests? Simply open an Issue or talk in the discussions.
Pull requests are also welcome.
This API is licensed under the AGPLv3. See the LICENSE file for details.
Caution
Using this in a proprietary application? Under the AGPLv3, if you integrate, modify, or host this API as part of your application (even over a network), you must open-source your entire application's code under the AGPL.
If you want to use this API without open-sourcing your own code, you must purchase a commercial license.
For commercial licensing, contact: EchterAlsFakeBS@proton.me