upload
sign up
sign in

API

Base URL

Example Response (JSON)

{
  "status": <status>,
  "error": <error message, otherwise null>,
  "result": <result object, otherwise null>
}

Status Codes

200 Request succeeded

400 Bad request

403 Permission denied

404 Not found

429 Too many requests

Get Upload URL

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "url": "https://ul43.xpornium.net/upload/1o9n44b3rnwlgn"
  }
}

Upload

URL

Note: You must get a new url for every upload. Get Upload Url

ENCODING

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
file Video file Yes
cat Video category 1 Yes
orientation Sexual Orientation
(1 - Straight, 2 - Gay, 3 - Lesbian, 4 - Transgender)
1 No
folder Upload to folder 24 No

Example

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "fileid": "abc1"
  }
}

Remote Upload

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
cat Video category 1 Yes
orientation Sexual Orientation
(1 - Straight, 2 - Gay, 3 - Lesbian, 4 - Transgender)
1 No
title Video title Hot title No
folder Upload to folder 24 No

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "id": 24,
    "fileid": "abc1"
  }
}

Remote Upload Status

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id Remote Upload ID 1 Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "id": 24,
    "url": "https://host.com/video.mp4",
    "name": "video.mp4",
    "progress": 0,
    "error": null,
    "added": "04-03-2021 09:53:52",
    "completed": null,
    "fileid": "abc1",
    "fileurl": null,
  }
}

File Info

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id Single file id or comma separated (max. 100) abc1,abc2 Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": [
    {
      "id": "abc1",
      "name": "video.mp4",
      "duration": 44,
      "folder": 0,
      "downloads": 0,
      "converted": true,
      "streamable": true,
	  "thumbnail": "https://example.com/thumbs/id.jpg",
      "deleted": false,
      "url": "https://xpornium.net/watch/abc1.jpg",
    },
    {
      "id": "abc2",
      "name": "video.mp4",
      "duration": 144,
      "folder": 1,
      "downloads": 0,
      "converted": true,
      "streamable": true,
      "deleted": true,
      "url": null,
    },
  ]
}

File Duplicate

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id File ID abc1 Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "fileid": "abc2",
  }
}

Edit File

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id File ID abc1 Yes
name File name Video1 No
cat Video categories 1,2,3 No
orientation Sexual Orientation
(1 - Straight, 2 - Gay, 3 - Lesbian, 4 - Transgender)
1 No
tags Video search tags tag1,tag2 No

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": true
}

File Delete

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id File ID abc1 Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": true
}

Removed Files

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
page Page number ( Listing limited to 100 per page ) 2 No

Response (JSON)

{
  "status": 200,
  "error": null,
  "pages": 1,
  "result": [
      {
        "fileid": "abc1",
        "name": "video.mp4",
        "status": "File removed due to inactivity",
        "date": "04-03-2021 09:53:52",
      },
      {
        "fileid": "abc2",
        "name": "video2.mp4",
        "status": "File removed due to inactivity",
        "date": "04-03-2021 09:53:52",
      }
   ]
}

Folder List

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id Folder ID 1 Yes
page Page number ( Listing limited to 100 per page ) 2 No

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "pages": 1,
    "folders": [
      {
        "id": 1,
        "name": "Folder1"
      }
    ],
    "files": [
      {
        "id": "abc1",
        "name": "video.mp4",
        "duration": 44,
        "folder": 0,
        "downloads": 0,
        "converted": true,
        "streamable": true,
        "deleted": false,
        "url": "https://xpornium.net/watch/abc1",
      },
      {
        "id": "abc2",
        "name": "video.mp4",
        "duration": 144,
        "folder": 0,
        "downloads": 0,
        "converted": true,
        "streamable": true,
        "deleted": true,
        "url": null,
      },
    ]
  }
}

Create Folder

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
name Folder Name Folder1 Yes
parent Parent Folder ID 1 No

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": {
    "id": 2,
  }
}

Rename Folder

URL

METHOD

Parameters

Name Description Example Required
login API Login [email protected] Yes
key API Key 3c6e0b8a9c15224a8228b9a98ca1531d Yes
id Folder ID 1 Yes
name Folder Name Folder1 Yes

Response (JSON)

{
  "status": 200,
  "error": null,
  "result": true
}

Categories

 

ID Name
9 Adult Toys
7 African
1 Amateur
3 Anal
5 Asian
11 ASMR
13 BBW
135 BDSM
15 Bi
21 Big Ass
91 Big Cock
93 Big Tits
77 Blonde
17 Blowjob
85 Brunette
25 Cam Porn
27 Casting
29 Caught
37 Celebrities
31 Cheating
33 Chubby
35 Compilation
63 Creampie
41 Cuckold
51 Cumshot
57 Finger
45 Fisting
55 Footjob
53 Fucked Up Family
47 Gangbang
23 Gapes
131 Granny
65 Indian
67 Interracial
69 Joi
73 Latina
71 Lesbian
75 Lingerie
79 Maid
43 Mature
39 MILF
59 Moms
89 Oiled
61 Oral
95 POV
99 Real
103 Redhead
101 Rough
115 Shemale
105 Solo
107 Squirting
123 Stepmother
121 Stepson
81 Stockings
109 Stuck
111 Teacher
87 Teen
133 Threesome
113 Trans
117 Vintage
127 Webcam
125 Wet
119 Wife
sign up
sign in
Contact Us Content Removal