/PHUB

A lightweight API for Pornhub

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

PHUB - An API for Pornhub.

Downloads PyPI version

PHUB is a hybrid API for Pornhub. It is able to communicate with Pornhub using both web-scraping and Pornhub's HubTraffic API. It is able to access most used or useful PH features, such as video searching, accessing account features, video downloading, and a lot more.

Warning

This project is probably against Pornhub TOS. Use at your own risks.

Installation

  • Install using pip (python 3.11 or higher required, recommended version):
pip install --upgrade phub
  • Or from this repo to get the latest fixes/features:
pip install --upgrade git+https://github.com/EchterAlsFake/PHUB.git
  • Or, for python 3.10 and higher. It Could also work for Python 3.6–9, but untested.
pip install --upgrade git+https://github.com/EchterAlsFake/PHUB.git@py-3.10

Quickstart

Note

You can find the docs on this project here.

import phub
from phub.locals import *

# Initialise a client
client = phub.Client()

# Fetch and download a video
video = client.get('https://...')
video.download('my-video.mp4', Quality.BEST)

# Fetch user videos
user = client.get_user('this-user')
for video in user.videos:
    print(video.title)

# Perform a research
for video in client.search('my-query'):
    print(video.title)

# Connect to an account
client = phub.Client('my-username', 'my-password')

# Access account history, liked and recommended stuff
client.account.watched
client.account.liked
client.account.recommended

Note

This repository was initiated and maintained by Egsagon He doesn't have any time to maintain this and transferred me the ownership. I'll do my best to maintain this repository functional.

License

PHUB uses GPLv3. See the LICENSE file.

Contributing

Feel free to contribute to this project by submitting feature requests, issues, bugs, or whatever.