Skip to main content

A Python API for the Porn Site xvideos.com

Project description

Porntrex API

Downloads CodeQL Analysis Sync API Tests

Description

Porntrex API is an API for porntrex.com. It allows you to fetch information from videos using httpx and Beautifulsoup.

Disclaimer

[!IMPORTANT] XVideos API is in violation to the ToS of xvideos.com! If you are the website owner of xvideos.com, contact me at my E-Mail, and I'll take this repository immediately offline. EchterAlsFake@proton.me

Features

  • Fetch Video Information
  • Download videos
  • Fetch Model information
  • Download Model videos
  • Fetch Channel information
  • Download Channel videos
  • Search for videos
  • Proxy Support
  • Http2 support
  • Very good code quality with almost perfect type hinting

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 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.0.tar.gz (11.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.0-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: porntrex_api-1.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for porntrex_api-1.0.tar.gz
Algorithm Hash digest
SHA256 b50eb5570b4ad165d42635470583ba2bf8552c39a3f4da95ee8cf41a71e21b4f
MD5 8f33cbbb91c03e7889921d6c5397df18
BLAKE2b-256 36614f1cc03ab2ed5996d9a5ead8589238a2bac8141becc915cea0fe68a73058

See more details on using hashes here.

File details

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

File metadata

  • Download URL: porntrex_api-1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for porntrex_api-1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 01b3e798b35f23deea10a4c2e2aa4d1a679cbe240a6dcae515de3488c422c194
MD5 868a4867550438ef38638833acfcd7ec
BLAKE2b-256 adcb78169e76560dc40d3daf9feb0d27f312bed01a47772be2ad7e2cf496b6e9

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