Skip to main content

An asynchronous Python API wrapper and scraper for 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


Release history Release notifications | RSS feed

This version

1.6

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_porntrex-1.6.tar.gz (10.5 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_porntrex-1.6-py3-none-any.whl (14.0 kB view details)

Uploaded Python 3

File details

Details for the file unofficial_api_for_porntrex-1.6.tar.gz.

File metadata

  • Download URL: unofficial_api_for_porntrex-1.6.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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_porntrex-1.6.tar.gz
Algorithm Hash digest
SHA256 745868b4cd601d2211e9372ff094b05f1c19c2090ff7de1818e22b5d26339fda
MD5 3f2e4ecd1a36d303ec714de34f026856
BLAKE2b-256 fd49ee78470fb2dc1051302ea022ee989f2b19553561cc1c759ce5bd2839d90e

See more details on using hashes here.

File details

Details for the file unofficial_api_for_porntrex-1.6-py3-none-any.whl.

File metadata

  • Download URL: unofficial_api_for_porntrex-1.6-py3-none-any.whl
  • Upload date:
  • Size: 14.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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_porntrex-1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 f05404aade399f8ce45386a67a30535e377bce4d636c28a4d762c9835ff44046
MD5 4c370b4ab2e288de346773d89daf6317
BLAKE2b-256 d276a663b069cd4bccc6f436ea6485fede2e5f2bea85a7639e08ffc87255b2f3

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