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
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
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
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
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
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
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
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
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
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
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
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
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 |
