Some features currently do not work. They will be listed in red.

Faulty endpoints will be listed in yellow.

Read Root

Summary: Retrieves the root endpoint.

Responses:
200: Successful Response

/

Get Pornpics Tags

Summary: Retrieves the tags for Pornpics.

Responses:
200: Returns a dictionary where keys are indices and values are tags.
500: Internal server error if something goes wrong.

/pornpics/tags

Get Xvideos Video by ID

Summary: Retrieves an Xvideos video by its ID. Works only for a very limited amount of videos

Parameter Description Type
id Video ID string

Responses:
200: Returns a dictionary with video details.
422: Validation error if ID is not provided.
400: Error retrieving the video.

/xvideos/video?video_id=udvhacb1297

Get Xvideos Feed

Summary: Retrieves the Xvideos feed. Works only for a very limited amount of videos

Parameters:

Parameter Description Type
amount (optional) Response amount (1 - 100) int

Responses:
200: Returns a dictionary with Xvideos feed items.
422: Amount needs to be between 1 and 100.
400: Error retrieving the feed.

/xvideos/feed?amount=30

Get RedGifs Feed

Summary: Retrieves the RedGifs feed based on the specified parameter. (CURRENTLY DOES NOT WORK)

Parameters:

Parameter Description Type
parameter (required) One of 'horizontal_gifs', 'hot_creators', 'hot_gifs', 'hot_images', 'long_gifs', 'new_creators', 'sound_gifs', 'verified_gifs', 'verified_images', 'vertical_gifs' string

Responses:
200: Returns a dictionary with feed items.
422: Invalid parameter or parameter missing.
404: No data found for the specified parameter.
400: Error retrieving the feed.

/redgifs/feed?parameter=parameter

Get RedGifs Tags

Summary: Retrieves the tags for RedGifs.

Parameter Description Type
trending (optional) If true, retrieves trending tags. Default is false. boolean

Responses:
200: Returns a dictionary with tags.
400: Error retrieving tags.

/redgifs/tags?trending=true

Get RedGifs GIF

Summary: Retrieves a RedGifs GIF by its ID.

Parameter Description Type
id (required) GIF ID string

Responses:
200: Returns a dictionary with GIF data.
422: Validation error if ID is not provided.
400: Error retrieving the GIF.

/redgifs/gif?gif_id=tighthappygoluckyasiandamselfly

Get RedGifs Creator

Summary: Retrieves RedGifs creator data by its username.

Parameter Description Type
username (required) Creator Username string
count (optional) Number of results to return (1 - 100) int
page (optional) Page number (1 - 5, default 1) int

Responses:
200: Returns a dictionary with creator data.
422: Validation errors for count or page.
400: Error retrieving creator data.

/redgifs/creator?username=liaredgifs6&count=10&page=1

Get Pornstar Data

Summary: Retrieves model data.

Parameter Description Type
name Search name string

Responses:
200: Successful Response
422: Validation Error
404: Model not found

pornstar/pornstar-data?name=Mia Khalifa

Get Eporner Video By ID

Summary: Retrieves video information based on id.

Parameter Description Type
video_id A string representing the gallery to scrape images from. string
format (optional) How results should be formatted? Valid values: 'json' (output will be in JSON format), 'xml' (output will be in XML format). Default value: 'json' string
thumbsize (optional) Thumbnails size. Valid values: 'small' (thumbnail size 190x152), 'medium' (thumbnail size 427x240), 'big' (thumbnail size 640x360). Default value: 'medium' string

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/eporner/video?id=ebMwkPk4Cq4&thumbsize=big&format=json

Get Pimpandhost Categories

Summary: Retrieves categories based off the specified filter parameter.

Parameter Description Default Value Type
filter_ Filter for categories, * = all, None = trending, letter = all tags that start with that letter None string

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/pimpandhost/categories

Get Pimpandhost Pornstars

Summary: Retrieves a list of pornstars based off the specified filter parameter.

Parameter Description Default Value Type
filter_ Filter for categories, None = trending, letter = all pornstars whose names that start with that letter None string

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/pimpandhost/pornstars?filter_=a

Get Pimpandhost Gifs

Summary: Retrieves the lastest gifs.

Parameter Description Default Value Type
per_page Number of results (1 - 100) 1 int
page (optional) Page number (1 - 5, default 1) 1 int

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/pimpandhost/gifs?page=1&per_page=100

Get Pimpandhost Category Media

Summary: Retrieves media from the specified category parameter.

Parameter Description Default Value Type
category Search category (ie: Amateur) None string
per_page Number of results (1 - 100) 1 int
page (optional) Page number (1 - 5, default 1) 1 int

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/pimpandhost/category-media?category=Amateur&page=1&per_page=100

Get Pimpandhost Pornstar Media

Summary: Retrieves media based off the specified pornstar name parameter.

Parameter Description Default Value Type
pornstar Pornstar name (ie: Mia Khalifa) None string
per_page Number of results (1 - 100) 1 int
page (optional) Page number (1 - 5, default 1) 1 int

Responses:
200: Successful Response
422: Validation Error
404: Video not found

/pimpandhost/pornstar-media?pornstar=Mia%20Khalifa&page=1&per_page=100