Skip to main content

A Python API for the Porn Site youporn.com

Project description

YouPorn API

Downloads CodeQL Analysis Sync API Tests

Description

YouPorn API is an API for youporn.com. It allows you to fetch information from videos, search for videos and get channels, pornstars and collections aka playlists using httpx and beautifulsoup.

Disclaimer

[!IMPORTANT] YouPorn API is in violation to the ToS of youporn.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

Quickstart

Have a look at the Documentation for more details

  • Install the library with pip install youporn_api
from youporn_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.rating)
# Download the video

video_object.download(downloader="threaded", 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.

Paypal: https://paypal.me/EchterAlsFake
XMR (Monero): 42XwGZYbSxpMvhn9eeP4DwMwZV91tQgAm3UQr6Zwb2wzBf5HcuZCHrsVxa4aV2jhP4gLHsWWELxSoNjfnkt4rMfDDwXy9jR

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

youporn_api-1.1.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

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

youporn_api-1.1-py3-none-any.whl (12.0 kB view details)

Uploaded Python 3

File details

Details for the file youporn_api-1.1.tar.gz.

File metadata

  • Download URL: youporn_api-1.1.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for youporn_api-1.1.tar.gz
Algorithm Hash digest
SHA256 49bf611b4b5601f131bfaf4a3df2471e8d69ab23cad03da7f8dbc49e6b7ffab8
MD5 47ca40a3403adaa0e1594bc8baebf04f
BLAKE2b-256 8d818e6c73ed563da3d30f939d75999fa0b0b7840a65594ede40ac4b4c7a5a40

See more details on using hashes here.

File details

Details for the file youporn_api-1.1-py3-none-any.whl.

File metadata

  • Download URL: youporn_api-1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for youporn_api-1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e3fc80313e5e88aecfe14e72101462ee3c0c30ce50d6187db1f76ce13cac0dfb
MD5 519b5c0b3c0e529af8c4ed5970e6aa3b
BLAKE2b-256 d9b979137b209512b71110e46988fee5c23a41af2d20f9393776bf41d4b23b64

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