Caution
Most requests require a API Login & API Key, you can find both in the User Panel at the "User Settings" Tab.
Please make sure to use the API with https only.
Base-URL for our API is https://api.bitporno.com/v2 (note the v2 for version 2 behind the /)
All requests to the API shall be HTTP/1.1 GET
Most requests require a API Login & API Key, you can find both in the User Panel at the "User Settings" Tab.
Please make sure to use the API with https only.
{
"status": <status-code>,
"msg": "<informational message. might vary, use the status code in your code!>",
"result": <result of the request. varies depending on the request>
}
Status # | Response |
---|---|
200 | Everything is OK. Request succeeded |
400 | Bad request (e.g. wrong parameters) |
403 | Permission denied (wrong api login/key, action on a file which does not belong to you, ...) |
404 | File not found |
451 | Unavailable For Legal Reasons |
50x | Server errors. You should not see this, but be prepared. |
Key # | Text |
---|---|
msg | This message gives more detailed information in case there is an error. You can use this for displaying it to the user, but please don't use it for checking if the request succeeded. That's what the status code is for. |
result | holds the response of the request if succeeded. Might hold an array of data or just a boolean true/false, depending on the request |
https://api.bitporno.com/v2/account/info?login=<api_username>&key=<api_password>
Name | Description | Example | Required |
---|---|---|---|
login | API-Login | 5147a8f8e924bc82 | yes |
key | API-Key / API-Password | Fa89_X13-37a8CKR | yes |
200 (OK)
Content-Type: application/json
{
"status": 200,
"msg": "OK",
"result": {
"user_id": "1",
"user_email": "[email protected]",
"user_regdate": "1206633247",
"premium_active": "0"
}
}
https://api.bitporno.com/v2/file/info?login=<api_username>&key=<api_password>&file=<files>
Name | Description | Example | Required |
---|---|---|---|
file | File-ID(s), single file or comma-separated (max. 50) | FXR1I5PIK1,FXQXRRATXY | yes |
login | API-Login | 5147a8f8e924bc82 | yes |
key | API-Key / API-Password | Fa89_X13-37a8CKR | yes |
200 (OK)
Content-Type: application/json
{
"status": 200,
"msg": "OK",
"result": {
"FXR1I5PIK1": {
"id": "FXR1I5PIK1",
"status": 200,
"name": "Jess_Anders.mp4",
"description": "",
"upload_date_unix_timestamp":"1495385231",
"last_view_date_unix_timestamp":"1546755399",
"views_count":"130",
"md5":"n\/a",
"available_qualities":{
"360p":true,
"480p":true,
"720p":true,
"1080p":false
}
},
"FXQXRRATXY": {
"id": "FXQXRRATXY",
"status": 200,
"name": "video_156.mp4",
"description": "",
"upload_date_unix_timestamp":"1485385231",
"last_view_date_unix_timestamp":"1536755399",
"views_count":"3",
"md5":"n\/a",
"available_qualities":{
"360p":false,
"480p":false,
"720p":true,
"1080p":false
}
}
}
}
https://upload.bitporno.com/bp/?login=<api_username>&key=<api_password>&folder=<folder_id>&sha1=<sha1>&httponly=<httponly>
Name | Description | Example | Required |
---|---|---|---|
file | File itself | Binary data of one file | yes |
login | API-Login | 5147a8f8e924bc82 | no |
key | API-Key / API-Password | Fa89_X13-37a8CKR | no |
sha1 | Expected sha1. If sha1 of uploaded file doesn't match this value, upload fails |
2fd4e1c67a2d28fced849ee1bb76e7391b93eb12 | no |
folder | Folder-ID to upload to | 1234 | no |
httponlyIf | if this is set to true, output only http links | false | no |
200 (OK)
Content-Type: application/json
{
"status": 200,
"msg": "OK",
"result": {
"url": "https://13abc37.example.com/ul/fCgaPthr_ys",
"valid_until": "2015-01-09 00:02:50"
}
}
This feature allows you to list files and folders for your account.
https://api.bitporno.com/v2/file/listfolder?login=<login>&key=<key
Name | Description | Example | Required |
---|---|---|---|
login | API-Login | 5147a8f8e924bc82 | yes |
key | API-Key / API-Password | Fa89_X13-37a8CKR | yes |
folder_id | Expected folder_id. If empty, it print your list of root directory. |
123 | no |
mode | if mode is set to 1, you will get the items from last 24h as result. | 0 | no |
200 (OK)
Content-Type: application/json
{
"status":200,
"msg":"OK",
"result":
{
"folders":{
"folder_id":"26",
"parent_folder_id":"0",
"name":"work",
"description":""
},
"files":[{
"name":"Valentine's day saved by her step son.mp4",
"description":"Ever get stood up or rejected on Valentine's Day?
Happens to the best of us really. But do you know who would never let you
down? Your family of course! Or rather your Step-Family. Except when it comes
to the classic, out-of-reach, always working husband who neglects his poor
wife even on the day of lovers. Alana Cruise is fed up with her husband
always missing the important days of the year. Crying and hopeless with
the idea of her favorite day ruined, her stepson overhears her. Compassionate
and sad for her, he tries his best to comfort her but he knows too well how
his dad can be. All she wants is to get back at him and an idea comes to mind.
What's the best way to get back at him you ask? How about a good old fashioned
revenge fuck? How about fucking her husband's son, that'd show him, right?
Nothing like a perfect young and capable man to fill the hole her husband
left when he decided to ruin her day. Like any good son, he wouldn't miss
the opportunity to piss off his own father. He treats her to a 3-course
meal, an entrée of big cock, followed by a relentless
pussy smashing, ending the feast with a delicious, creamy dessert.
Who wouldn't treat their step-mother on a day as important as this one?
On this day dedicated to couples, how about you treat yourself and take
the matter into your own hands.",
"folder_id":"0",
"upload_at":"1594101441",
"last_at":"1594101441",
"status":"1",
"views":"0",
"linkextid":"GGJIW5DU5H",
"link":"https:\/\/www.bitporno.com\/v\/GGJIW5DU5H"
}]
}
}
https://api.bitporno.com/v2/file/converts?login=<api_username>&key=<api_password>&file=<files>&output=<format>
Name | Description | Example | Required |
---|---|---|---|
login | API-Login | 5147a8f8e924bc82 | yes |
key | API-Key / API-Password | Fa89_X13-37a8CKR | yes |
file | ID of an file | FXSNPOKMT4 | yes |
output | By default, all formats are displayed, you can specifiy 360p, 480p, 720p or 1080p to limit the result output. | 480p | no |
200 (OK)
Content-Type: application/json
{
"status": 200,
"msg": "OK",
"result": {
"FXSNPOKMT4": {
"encoding_summary": "success",
"is_playable": 1,
"link": "https://www.bitporno.com/v/VXSNPOKMT3",
"linkextid": "VXSNPOKMT3",
"encoding_status": [
{
"codec_id": "85",
"job_id": "97516672",
"converted": "1",
"locked": "0",
"created_timestamp": "1543752473",
"updated_timestamp": "1543756167",
"skipped": "0",
"progress": "100",
"retires": "2",
"label": "360p"
},
{
"codec_id": "86",
"job_id": "97516674",
"converted": "1",
"locked": "0",
"created_timestamp": "1543752473",
"updated_timestamp": "1543752936",
"skipped": "0",
"progress": "100",
"retires": "4",
"label": "480p"
},
{
"codec_id": "87",
"job_id": "97516676",
"converted": "1",
"locked": "0",
"created_timestamp": "1543752473",
"updated_timestamp": "1543752698",
"skipped": "1",
"progress": "0",
"retires": "1",
"label": "720p"
},
{
"codec_id": "88",
"job_id": "97516678",
"converted": "1",
"locked": "0",
"created_timestamp": "1543752473",
"updated_timestamp": "1543752704",
"skipped": "1",
"progress": "0",
"retires": "1",
"label": "1080p"
}
]
}
}
}
Shows the video splash image (thumbnail). Optionally, you can choose another image.
https://api.bitporno.com/v2/file/getsplash?login=<api_username>&key=<api_password>&file=<files>&splash=<splash_no>
Name | Description | Example | Required |
---|---|---|---|
login | API-Login | 5147a8f8e924bc82 | yes |
key | API-Key / API-Password | Fa89_X13-37a8CKR | yes |
file | ID of an file | FXSNPOKMT4 | yes |
splash | By default, ID 0 will choosen, that is, the big thumbnail picture are returned. You can choose another image up to ID 5 to choose an image from tileset. | 1 | no |
200 (OK)
Content-Type: application/json
{
"status": 200,
"msg": "OK",
"result": "https://foot.playercdn.net/thumb/0/181101/118FXR1IB1ZAZWGNG6LV5.jpg"
}