Skip to main content

A Python API for the Porn Site porntrex.com

Project description

Porntrex API

Downloads CodeQL Analysis Sync 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

  • Fetch videos + metadata
  • Download videos
  • Fetch Channels
  • Fetch Pornstars
  • Search for videos
  • Built-in caching
  • Easy interface
  • Great type hinting
  • Proxy support
  • Very customizable

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 porntrex_api
from porntrex_api import Client
# Initialize a Client object
client = Client()

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

# Information from Video objects
print(video_object.title)
print(video_object.duration)
# Download the video

video_object.download(quality="best", path="your_output_path + filename")

# SEE DOCUMENTATION FOR MORE

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.

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

Licensed under the LGPLv3 License
Copyright (C) 2025-2026 Johannes Habel

Project details


Download files

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

Source Distribution

porntrex_api-1.5.1.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

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

porntrex_api-1.5.1-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

File details

Details for the file porntrex_api-1.5.1.tar.gz.

File metadata

  • Download URL: porntrex_api-1.5.1.tar.gz
  • Upload date:
  • Size: 10.0 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 porntrex_api-1.5.1.tar.gz
Algorithm Hash digest
SHA256 0284a5ebed4f16c22e6863291ec2e87cf5218e22650b644e2bc2a3a116b253f5
MD5 2be3dcb3a483d083f4ef5187fbc46a40
BLAKE2b-256 277dc24d3a4ca2fa0581d3f1463bb511d171b94e475dd17044838dd551ffdcab

See more details on using hashes here.

File details

Details for the file porntrex_api-1.5.1-py3-none-any.whl.

File metadata

  • Download URL: porntrex_api-1.5.1-py3-none-any.whl
  • Upload date:
  • Size: 13.8 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 porntrex_api-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5855c3525a089b9cd9f988becc3eee7c22321d1bb0e94f5b59bfc9bb1a4d8c9b
MD5 c244a678719e97ed6c7964ad2d4ff0d0
BLAKE2b-256 2582c228285a1ff7176ab2a98e0b368db8487170fd3c76f608b738c0c5bb725b

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