XTube API & Feed Documentation

XTube Feed Documentation

Why put only a few Xtube videos on your site when there are no restrictions to the number of videos you can place on your site? Make the size of your site grow right away by embedding all of our videos at once to your site! Below is a link to easily import our database of embeddable videos to your site. It is a .CSV file inside a .ZIP, containing video URLs, thumbnail URLs, tags, duration, title, and embed codes. Embed all Xtube videos on your site at once:


Available Feeds

Full Dump of Videos [created weekly] Deleted feed (CSV) Deleted feed Alltime(CSV) [created weekly] Deleted feed with ID (CSV) Full Dump of Videos [category = Amateur] [created daily] Full Dump of Videos [category = Anal] [created daily] Full Dump of Videos [category = Anime] [created daily] Full Dump of Videos [category = Asian] [created daily] Full Dump of Videos [category = BBW] [created daily] Full Dump of Videos [category = BDSM] [created daily] Full Dump of Videos [category = Bear] [created daily] Full Dump of Videos [category = Beautiful Women] [created daily] Full Dump of Videos [category = Big Boobs] [created daily] Full Dump of Videos [category = Big Cock] [created daily] Full Dump of Videos [category = Bisexual] [created daily] Full Dump of Videos [category = Blow Jobs] [created daily] Full Dump of Videos [category = Blowjob] [created daily] Full Dump of Videos [category = Bush] [created daily] Full Dump of Videos [category = Butts] [created daily] Full Dump of Videos [category = Daddies] [created daily] Full Dump of Videos [category = Ebony] [created daily] Full Dump of Videos [category = Entertainment] [created daily] Full Dump of Videos [category = Fetish] [created daily] Full Dump of Videos [category = Fisting] [created daily] Full Dump of Videos [category = Fursuits] [created daily] Full Dump of Videos [category = General Gay] [created daily] Full Dump of Videos [category = Group Sex] [created daily] Full Dump of Videos [category = Hardcore] [created daily] Full Dump of Videos [category = Humor] [created daily] Full Dump of Videos [category = Hunks] [created daily] Full Dump of Videos [category = Interracial] [created daily] Full Dump of Videos [category = Jerk Off] [created daily] Full Dump of Videos [category = Jerk-off] [created daily] Full Dump of Videos [category = Latina] [created daily] Full Dump of Videos [category = Latino] [created daily] Full Dump of Videos [category = Lesbian] [created daily] Full Dump of Videos [category = Live] [created daily] Full Dump of Videos [category = MILF] [created daily] Full Dump of Videos [category = Mature] [created daily] Full Dump of Videos [category = Miscellaneous] [created daily] Full Dump of Videos [category = Muscle Guys] [created daily] Full Dump of Videos [category = My Cock] [created daily] Full Dump of Videos [category = News] [created daily] Full Dump of Videos [category = Personal & Dating] [created daily] Full Dump of Videos [category = Premium DVDs] [created daily] Full Dump of Videos [category = Softcore] [created daily] Full Dump of Videos [category = Squirt] [created daily] Full Dump of Videos [category = Straight] [created daily] Full Dump of Videos [category = Swinger] [created daily] Full Dump of Videos [category = Swingers] [created daily] Full Dump of Videos [category = Teens] [created daily] Full Dump of Videos [category = Toys] [created daily] Full Dump of Videos [category = Transexual] [created daily] Full Dump of Videos [category = Twinks] [created daily] Full Dump of Videos [category = Video Blog] [created daily] Full Dump of Videos [category = Voyeur] [created daily] Full Dump of Videos [category = Yaoi] [created daily]





XTube API Documentation

Here you can find detailed information needed to get data and integrate XTube videos on your website or application. Below you can find a list of all supported API methods with a short description and result examples.


Available Methods

getCategoryList
getTagList
getAmateurList
getAmateurListDetailed
isVideoActive
getVideoById
getDeletedVideos
getVideoEmbedCode
getVideosBySearchParams


Additional Documents

Possible Params for Video Search (text)


Get all active categories on XTube

Retrieves all available categories.

API-Url: http://www.xtube.com/webmaster/api/getcategorylist

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[{
    "category_name": "Amateur"
}, {
    "category_name": "Anal"
}, {
    "category_name": "Asian"
}, {
    "category_name": "Blowjob"
}, {
    "category_name": "Big Boobs"
}]

Get all active tags on XTube

Retrieves all tags available.

API-Url: http://www.xtube.com/webmaster/api/gettaglist

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[{
    "tag_name": "10inches"
}, {
    "tag_name": "2-hour-comp"
}, {
    "tag_name": "2loversin1"
}, {
    "tag_name": "2men"
}, {
    "tag_name": "2xist"
}]

Get all active amateurs on XTube

Retrieves all amateurs available.

API-Url: http://www.xtube.com/webmaster/api/getamateurlist

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[{
    "amateur_name": "-----pfil"
}, {
    "amateur_name": "---FOOTBALLERTOP---"
}, {
    "amateur_name": "--TEEN"
}, {
    "amateur_name": "--erika--"
}, {
    "amateur_name": "-akureichan-"
}, {
    "amateur_name": "-bbboy"
}]

Get all active amateurs with additional information on XTube

Retrieves all amateurs available with details (page url and amateurs's thumb).

API-Url: http://www.xtube.com/webmaster/api/getamateurlistdetailed

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[{
    "amateur_name": "-----pfil",
    "amateur_url": "https:\/\/www.xtube.com\/community\/profile.php?user=-----pfil",
    "amateur_thumb": {
        "width": 400,
        "height": 400,
        "url": "https:\/\/cdn1.publicphoto.xtube.com\/m=eqgK9f\/amateur_img\/wasdtfd4_200801\/v0xCeroe0BX.jpg"
    }
}, {
    "amateur_name": "---FOOTBALLERTOP---",
    "amateur_url": "https:\/\/www.xtube.com\/community\/profile.php?user=---FOOTBALLERTOP---",
    "amateur_thumb": {
        "width": 400,
        "height": 400,
        "url": "https:\/\/cdn2.publicphoto.xtube.com\/m=eqgK9f\/amateur_img\/wasdtfd4_200903\/Mq723qNO9Uz.jpg"
    }
}, {
    "amateur_name": "--TEEN",
    "amateur_url": "https:\/\/www.xtube.com\/community\/profile.php?user=--TEEN",
    "amateur_thumb": {
        "width": 400,
        "height": 400,
        "url": "https:\/\/cdn2.publicphoto.xtube.com\/m=bLaYGSV\/amateur_img\/wasdtfd4_200802\/rhQiN3rVRuv.jpg"
    }
}, {
    "amateur_name": "--erika--",
    "amateur_url": "https:\/\/www.xtube.com\/community\/profile.php?user=--erika--",
    "amateur_thumb": {
        "width": 400,
        "height": 400,
        "url": "https:\/\/cdn1.publicphoto.xtube.com\/m=eqgK9f\/amateur_img\/201106\/25\/AazyFRjKOa5.jpg"
    }
}, {
    "amateur_name": "-akureichan-",
    "amateur_url": "https:\/\/www.xtube.com\/community\/profile.php?user=-akureichan-",
    "amateur_thumb": {
        "width": 400,
        "height": 400,
        "url": "https:\/\/cdn2.publicphoto.xtube.com\/m=eqgK9f\/amateur_img\/wasdtfd4_200804\/qqRJH9BvAKR.jpg"
    }
}]

Check if a video is still active or available on XTube

Retrieves state of a specific video specified by video_id parameter, which is useful in order to keep your embedded videos up to date.

API-Url: http://www.xtube.com/webmaster/api/isvideoactive?video_id=RF4Nk-S774-

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

{
    "video_id": "RF4Nk-S774-",
    "active": true
}

Get detailed information about specified video

Retrieves additional information about specific video by video_id parameter.

API-Url: http://www.xtube.com/webmaster/api/getvideobyid?video_id=RF4Nk-S774-

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

{
   "duration":"180",
   "views":2450,
   "video_id":"RF4Nk-S774-",
   "rating":"4.000",
   "ratings":"1",
   "title":"Homegrown Big Tits",
   "description":"Dedicated to the fans of the beautiful amateur women with big natural tits.  All user submitted - you can see big boob amateur hotties fucking and sucking as their tits bounce and sway.",
   "url":"https:\/\/www.xtube.com\/video-watch\/Homegrown-Big-Tits-18634762",
   "embedCode":"https:\/\/xtube.com\/video-watch\/embedded\/Homegrown-Big-Tits-18634762",
   "default_thumb":"https:\/\/cdn6-s-hw-e5.xtube.com\/m=eSK08f\/videos\/201302\/07\/RF4Nk-S774-\/240X180\/1.jpg",
   "thumb":"https:\/\/cdn6-s-hw-e5.xtube.com\/m=eSK08f\/videos\/201302\/07\/RF4Nk-S774-\/240X180\/1.jpg",
   "publish_date":"2013-02-07 17:41:10",
   "tags":{
      "1396":"bigtits",
      "459982":"http:",
      "472012":"homeg"
   },
   "thumbs":[
      {
         "width":300,
         "height":210,
         "src":"https:\/\/cdn7-s-hw-e5.xtube.com\/m=eSK08f\/videos\/201302\/07\/RF4Nk-S774-\/240X180\/1.jpg"
      },
      {
         "width":300,
         "height":210,
         "src":"https:\/\/cdn5-s-hw-e5.xtube.com\/m=eSK08f\/videos\/201302\/07\/RF4Nk-S774-\/240X180\/2.jpg"
      },
      {
         "width":300,
         "height":210,
         "src":"https:\/\/cdn7-s-hw-e5.xtube.com\/m=eSK08f\/videos\/201302\/07\/RF4Nk-S774-\/240X180\/3.jpg"
      }
   ]
}

Get List of deleted videos on XTube

Retrieves all videos which are deleted during the last 2 weeks

API-Url: http://www.xtube.com/webmaster/api/getdeletedvideos

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[{
    "video_id": "3nFsB-S703-"
}, {
    "video_id": "T1lJt-S603-"
}, {
    "video_id": "FWtZ0-S203-"
}, {
    "video_id": "G2Eb9-S103-"
}, {
    "video_id": "k4icz-S103-"
}, {
    "video_id": "tPDWS-S503-"
}]

Get list of videos filtered by parameters

Retrieves video list, can be filtered by multiple parameters, including the possibility to query the API for videos containing a specific string in the title or description. The response is limited to 1000 Items per request

API-Url: http://www.xtube.com/webmaster/api/getvideosbysearchparams?search=fuck&count=10&thumbsize=180x35&fields=rating,username,title,tags,duration,thumbnail,url,embed,categories

Accepted params:
search=text [optional text is space separated]
orientation=string [all|gay|straight, default all]
category=string [optional, comma seperated, only categories from provided list, 10 different categories max]
user=string [optional, comma seperated, 20 different user max]
tags=string [optional, comma seperated, only tags from provided list, 50 different tags max]
ordering=[latest/mostviewed/rating] [optional]
period=[lastweek/lastmonth/alltime] [optional only work with ordering parameter]
count=integer [optional, 10-7500, default = 1000]
rating=integer [optional, 0-100, default = 0 (all)]
fields=string [id|rating|username|title|tags|duration|thumbnail|url|embed|categories|description|views, comma seperated, multiple fields possible, if no field is set you will get extended output]
thumbsize=string [180x35|180x135|240x180|320x240|400x300|180x101|240x135|320x180, default 400x300]
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

[
   {
      "rating":"4.896",
      "username":"BestOfSeth",
      "title":"Keeping it in... Lube is thicker than Water",
      "tags":{
         "12":"cum",
         "24":"fucking",
         "79":"anal",
         "140":"hairy",
         "155":"daddies",
         "383":"rim",
         "797":"younger",
         "905":"love",
         "1318":"frat",
         "2397":"bro"
      },
      "duration":"8:29",
      "thumbnail":"https:\/\/cdn9-s-ha-e5.xtube.com\/m=eSK08f\/videos\/201702\/26\/vE9WH1xQ___\/original\/99.jpg?h=5959e6c30ff858.18379893",
      "url":"https:\/\/www.xtube.com\/video-watch\/Keeping-it-in-Lube-is-thicker-than-Water-30205791",
      "embed":"https:\/\/xtube.com\/video-watch\/embedded\/Keeping-it-in-Lube-is-thicker-than-Water-30205791",
      "categories":{
         "1":"Amateur",
         "25":"Anal",
         "40":"Gay Daddies"
      }
   },
   {
      "rating":"4.286",
      "username":"bearandhisboy",
      "title":"***** gets fucked by bear on the dinnertable",
      "tags":{
         "12":"cum",
         "24":"fucking",
         "71":"bear",
         "100":"young",
         "122":"twink",
         "138":"daddy",
         "818":"older"
      },
      "duration":"5:15",
      "thumbnail":"https:\/\/cdn6-s-ha-e5.xtube.com\/m=eSK08f\/amateur_img\/200807\/zW897D5lhPU-0002.jpg",
      "url":"https:\/\/www.xtube.com\/video-watch\/-gets-fucked-by-bear-on-the-dinnertable-544778",
      "embed":"https:\/\/xtube.com\/video-watch\/embedded\/-gets-fucked-by-bear-on-the-dinnertable-544778",
      "categories":{
         "28":"Gay Bear",
         "34":"Gay Twinks",
         "40":"Gay Daddies"
      }
   }
]

Get embed code for specified video

Retrieves embed code for specific video by video_id parameter, which is useful to automatically embed videos.

API-Url: http://www.xtube.com/webmaster/api/getvideoembedcode?video_id=RF4Nk-S774-

Accepted params:
format=string [csv|json|xml, default json]
delimiter=string [pipe|comma|tab|colon, default pipe]

{
    "embedCode": "<iframe src='https:\/\/www.xtube.com\/embedded\/user\/play.php?v=RF4Nk-S774-' frameborder=0 width='640' height='480' scrolling=no name='xt_embed_video'><\/iframe><br \/><a href='https:\/\/www.xtube.com\/watch.php?v=RF4Nk-S774-'>Homegrown Big Tits<\/a> powered by <a href='https:\/\/www.xtube.com'>XTube<\/a>"
}