API Documentation

Welcome to the API documentation page. This tool is meant to allow developers and webmasters to get data from our website and integrate this data to your own website or application. You will find below a list of the supported commands along with their role and how to use them.

XML and JSON formats are currently supported by using these parameters:

  • output=xml
  • output=json

Method media.newest

This method allows you to request the newest video published on .

Example XML

http://www.beardedperv.com/api/?output=xml&method=media.newest&offset=0&amount=10

Example JSON

http://www.beardedperv.com/api/?output=json&method=media.newest&offset=0&amount=10

Parameters

  • offset : The starting point of your request.
  • amount : The number of medias you wish to get as a result. The maximum is 500.

Method media.search

This method allows you to search for specific terms in the Title and Description fields of the videos.

Example XML

http://www.beardedperv.com/api/?output=xml&method=media.search&search=anal&offset=0&amount=10

Example JSON

http://www.beardedperv.com/api/?output=json&method=media.search&search=anal&offset=0&amount=10

Parameters

  • search : The terms for which you want to do the search.
  • offset : The starting point of your request.
  • amount : The number of medias you wish to get as a result. The maximum is 500.

Method media.categories

This method allows you to get the videos of specific categories.

Example XML

http://www.beardedperv.com/api/?output=xml&method=media.categories&categories=amateur,teen&offset=0&amount=10

Example JSON

http://www.beardedperv.com/api/?output=json&method=media.categories&categories=amateur,teen&offset=0&amount=10

Parameters

  • categories : The categories for which you want to get the videos. Note that multiple can be entered by seperating them with a comma (,)
  • offset : The starting point of your request.
  • amount : The number of medias you wish to get as a result. The maximum is 500.

Method media.pornstars

This method allows you to get the videos of specific pornstars.

Example XML

http://www.beardedperv.com/api/?output=xml&method=media.pornstars&pornstars=Mia Khalifa,Aaliyah Love&offset=0&amount=10

Example JSON

http://www.beardedperv.com/api/?output=json&method=media.pornstars&pornstars=Mia Khalifa,Aaliyah Love&offset=0&amount=10

Parameters

  • pornstars : The pornstars for which you want to get the videos. Note that multiple can be entered by seperating them with a comma (,)
  • offset : The starting point of your request.
  • amount : The number of medias you wish to get as a result. The maximum is 500.

Method media.data

This method allows you to get more information about a specific video such as the categories & pornstars related to it.

Example XML

http://www.beardedperv.com/api/?output=xml&method=media.data&id=71532

Example JSON

http://www.beardedperv.com/api/?output=json&method=media.data&id=71532

Parameters

  • id : The categories for which you want to get the videos. Note that multiple can be entered by seperating them with a comma (,)

XML Tags Output

TAG DESCRIPTION PARENT NODE
MaxCount Number of results maximum for your query, ignoring any offset or amount parameter. root
CurrentCount Number of results for your current query, including all parameters. root
duration Length of the video media root > video
views Number of views the video has received on . root > video
rating The rating the video has received on . root > video
url URL to the video on . root > video
embed_url URL to the embedded version of the video. root > video
embed_stack Embed video code ready to use. root > video
default_thumb Default thumbnail used for the video. root > video
publishDate Date when the video was published on . root > video
title Title of the video. root > video
description Description of the video. root > video
category Categories related to the video. Only available in media.data root > video > categories
pornstar Pornstars playing in the video. Only available in media.data root > video > pornstars
tag Tags associated with the video content. root > video > tags
thumb Thumbnails at multiple interval of the video. root > video > thumbs

JSON Tags Output

Errors

TAG DESCRIPTION PARENT NODE
MaxCount Number of results maximum for your query, ignoring any offset or amount parameter. root
CurrentCount Number of results for your current query, including all parameters. root
duration Length of the video media root > videos > video
views Number of views the video has received on . root > videos > video
rating The rating the video has received on . root > videos > video
url URL to the video on . root > videos > video
embed_url URL to the embedded version of the video. root > videos > video
default_thumb Default thumbnail used for the video. root > videos > video
publishDate Date when the video was published on . root > videos > video
title Title of the video. root > videos > video
description Description of the video. root > videos > video
category Categories related to the video. Only available in media.data root > videos > video > categories
pornstar Pornstars playing in the video. Only available in media.data root > videos > video > pornstars
tag Tags associated with the video content. root > videos > video > tags
thumb Thumbnails at multiple interval of the video. root > videos > video > thumbs
NUMBER DESCRIPTION
1001 The method parameter provided is invalid. You must provide one of the existing method mentionned above.
1002 The media parameter provided is invalid. At this time, only the videos type is supported (videos is also the default type).
2001 When using media.search, you must provide a search parameter such as &search=tits,teen. Please note that this parameter can take multiple values seperated by a comma
2002 When using media.pornstars, you must provide a pornstars parameter such as &pornstars=Mia Khalifa,Aaliyah Love. Please note that this parameter can take multiple values seperated by a comma
2003 When using media.categories, you must provide a search parameter such as &categories=amateur,teen. Please note that this parameter can take multiple values seperated by a comma
3001 Your query did not return any result. This can be caused by a non-existant parameter such as a category that does not exist in our system.