Skip to main content

Eporner API

An asynchronous Python API wrapper and scraper for eporner.com

Downloads + Downloads CodeQL Analysis API Tests

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

Category Details
Video Fetching Fetch video objects with full metadata (title, views, quality, publish date, authors, available qualities)
Video Downloading RAW/direct-based downloading with quality selection and fallback mechanisms
Pornstar Profiles Fetch pornstar/model profiles including total video count and their uploaded videos
Video Search Search videos with advanced filters for low quality mode, Gay/Straight, sorting order, and pagination
Category Search Browse and fetch videos under specific site categories
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 eporner_api -h for options
Type Safety Comprehensive type hinting and dataclass-based models throughout

Networking Features

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

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)

Installation

pip install unofficial-api-for-eporner

Quickstart

Have a look at the Documentation for more details

[!NOTE] Eporner API can also be used from the command line. Do: eporner_api -h to see the options

import asyncio
from eporner_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, mode="best")

if __name__ == "__main__":
    asyncio.run(main())

Support the Project ❤️

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!

☕ Ko-fi

https://ko-fi.com/EchterAlsFake

💳 PayPal

https://paypal.me/EchterAlsFake

🪙 Crypto (350+ currencies supported)

Crypto donation button by NOWPayments

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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unofficial_api_for_eporner-2.4.1.tar.gz (25.6 kB view details)

Uploaded Source

Built Distribution

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

unofficial_api_for_eporner-2.4.1-py3-none-any.whl (27.6 kB view details)

Uploaded Python 3

File details

Details for the file unofficial_api_for_eporner-2.4.1.tar.gz.

File metadata

  • Download URL: unofficial_api_for_eporner-2.4.1.tar.gz
  • Upload date:
  • Size: 25.6 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for unofficial_api_for_eporner-2.4.1.tar.gz
Algorithm Hash digest
SHA256 69304f9ca19df683806a95ec53b77ed9e6c0c718962164d3b8b6a1e45313a636
MD5 24d45a2a8983728a8a8c9dd8125797c4
BLAKE2b-256 452526f2a9718aefa7db3e022c190feb9f79ca535510d4af3e387bd805574f63

See more details on using hashes here.

File details

Details for the file unofficial_api_for_eporner-2.4.1-py3-none-any.whl.

File metadata

  • Download URL: unofficial_api_for_eporner-2.4.1-py3-none-any.whl
  • Upload date:
  • Size: 27.6 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for unofficial_api_for_eporner-2.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 46d32be92fb1a85e13dc30d7af7c59e4878ea75545df8de0330252c0e6a70921
MD5 4630bba2e4faad058883384bab6617c0
BLAKE2b-256 6048570e4a82e06d2eb1ff29f5038189897d21e58d05bec6ec7782e5e6f8f6a1

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 Sentry Error logging StatusPage Status page