https://github.com/echteralsfake/youporn_api
a Python API for the porn site youporn.com
https://github.com/echteralsfake/youporn_api
api beautifulsoup4 bs4 channels collections httpx package pornstars python searching video-download web-scraping
Last synced: 30 days ago
JSON representation
a Python API for the porn site youporn.com
- Host: GitHub
- URL: https://github.com/echteralsfake/youporn_api
- Owner: EchterAlsFake
- License: lgpl-3.0
- Created: 2025-08-16T09:25:25.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-17T18:57:04.000Z (about 2 months ago)
- Last Synced: 2025-12-21T07:17:14.139Z (about 2 months ago)
- Topics: api, beautifulsoup4, bs4, channels, collections, httpx, package, pornstars, python, searching, video-download, web-scraping
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
YouPorn API
# 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](https://github.com/EchterAlsFake/API_Docs/blob/master/Porn_APIs/YouPorn.md) for more details
- Install the library with `pip install youporn_api`
```python
from youporn_api import Client
# Initialize a Client object
client = Client()
# Fetch a video
video_object = client.get_video("")
# 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