DEPRECATED - USE PHUB INSTEAD

---

PH Fetch

A light python interface for fetching and downloading videos from PornHub.

LICENSE: MIT - See the LICENSE file.

Installation

Install using pip on python 3.11 or higher:

pip install phfetch

Or clone this repository to get the latest release.

Usage

Sample script to download a video given its URL:

import phfetch

video = phfetch.video(url = 'https://...')
# Or using directly the video viewkey
video = phfetch.video(key = '..........')

video.download('video.mp4', quality = 'best')

Sample script to search videoe:

result = phfecth.search('...')

# Get a specific video
print(result[0])

# Get the amount of available videos
# Note: in some cases, the number provided by PornHub
# is wrong. Going further this number will raise errors.
print(len(result))

# Endless scroll through videos:
for video in result:
  print(video.title)

PornHub API wrapper

Alongside being able to download videos, this API is able to parse some useful PornHub video informations, stored in all phfetch.Video objects.

property	Type	Description
video.title	str	Title of the video
video.image	str	URL of the thumbnail
video.duration	int	Video duration in seconds
video.hotspots	list[int]	List of hotspots location in seconds
video.orientation	bool	Whether the video is in landscape mode
video.views	Vote	Object with up and down attributes
video.tags	list[Tag]	List of objectd with name and count attibutes
video.datalayer	dict	Advanced data provided by PornHub (can be useful)
video.author	Author	Object representing a PornHub user

Note: All these properties are cached. If you want to reload them, use video.refresh().

Author object have the following attributes:

attribute	Type	Description
url	str	URL that leads to author profile
name	str	Author profile name
model_type	str	The author model type
videos	list[Video]	Author videos (not implemented)
subscribers	int	Amount of people subscribed (not implemented)

Note: Author objects are comparable.

Advanced downloading

To extract a video without dowloading it, call one of these functions:

video.M3U(quality = 'best') # Get the raw M3U8 file of the video

video.get_segments(quality = 'best') # Same as before but parses the file to get only URLs

This can be useful if you want to use a threaded download script of FFMPEG to download the video faster (currently, PHFetch just fetches one segment at a time and append it to a file).

Why?

This is a way of replacing yt-dl which is not able anymore (as of today) to download videos from PornHub. I understand this is messy (especially the author and searching stuff) and am planning to make a bigger API with better client-like structure.