Lulustream API

https://lulustream.com/api.html
Admin
Lulustream API provides programmatic access to manage user accounts, upload, edit, list, and...
Tokens:10,027
Snippets:37
Trust Score:9.1
Update:1 year ago
Show doc for...
Tokens:
Raw
### GET /api/folder/create

Source: https://lulustream.com/api.html/index

Creates a new folder. You can specify the folder name and the parent folder ID.

```APIDOC
## GET /api/folder/create

### Description
Creates a new folder. You can specify the folder name and the parent folder ID.

### Method
GET

### Endpoint
https://lulustream.com/api/folder/create

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **name** (STRING) - Required - Folder name
- **parent_id** (INT) - Optional - Parent Folder ID, default=0
- **descr** (STRING) - Optional - Folder description

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "name": "New Videos",
  "parent_id": 0,
  "descr": "new stuff"
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (OBJECT)
  - **fld_id** (STRING) - The ID of the newly created folder

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-18 20:32:46",
  "status": 200,
  "result": {
    "fld_id": "29"
  }
}
```
```

--------------------------------

### Get Account Info

Source: https://lulustream.com/api.html/index

Retrieves general account information such as login, email, storage usage, and premium status. Requires an API key.

```HTTP
GET https://lulustream.com/api/account/info?key=455utteiegakw78e8
```

--------------------------------

### Upload File via cURL

Source: https://lulustream.com/api.html/index

Provides examples of uploading files using `curl`. It shows how to upload multiple files, and how to include additional metadata like title and snapshot.

```bash
curl -X POST -F 'key=455utteiegakw78e8' -F 'file=@1.avi' -F 'file=@2.avi' https://s1.myvideo.com/upload/01
```

```bash
curl -X POST -F 'key=1l5ftrilhllgwx2bo' -F 'file_title="Hola!"' -F 'file=@1.avi' -F 'snapshot=@1.jpg' http://s1.lulustream.com/upload/01
```

--------------------------------

### GET /api/file/url_actions

Source: https://lulustream.com/api.html/index

Retrieves information about current encoding queues and allows for managing failed or all uploads.

```APIDOC
## GET /api/file/url_actions

### Description
Retrieves current encoding queues and provides options to manage upload statuses.

### Method
GET

### Endpoint
https://lulustream.com/api/file/url_actions

### Parameters
#### Query Parameters
- **key** (STRING) - Required - Your API key for authentication.
- **restart_errors** (INT) - Optional - Set to 1 to restart all failed uploads.
- **delete_errors** (INT) - Optional - Set to 1 to delete all failed uploads.
- **delete_all** (INT) - Optional - Set to 1 to delete all current uploads.
- **delete_code** (STRING) - Optional - A comma-separated string of codes to delete specific uploads.

### Request Example
```
GET https://lulustream.com/api/file/url_actions?key=455utteiegakw78e8&restart_errors=1
```

### Response
#### Success Response (200)
- **requests_available** (INT) - Number of available requests.
- **msg** (STRING) - Status message, typically "OK".
- **server_time** (STRING) - The current server time.
- **status** (INT) - HTTP status code.

#### Response Example
```json
{
  "requests_available": 2,
  "msg": "OK",
  "server_time": "2022-06-14 20:30:20",
  "status": 200
}
```
```

--------------------------------

### Get Upload Server API

Source: https://lulustream.com/api.html/index

Retrieves the URL of an available upload server.

```APIDOC
## GET /api/upload/server

### Description
Retrieves the URL of an available upload server.

### Method
GET

### Endpoint
/api/upload/server

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key

### Request Example
```
https://lulustream.com/api/upload/server?key=455utteiegakw78e8
```

### Response
#### Success Response (200)
- **msg** (STRING) - Message indicating success.
- **server_time** (STRING) - Server time.
- **status** (INT) - HTTP status code.
- **result** (STRING) - URL of the upload server.

#### Response Example
```json
{
    "msg": "OK",
    "server_time": "2021-08-11 04:29:54",
    "status": 200,
    "result": "https://s1.myvideo.com/upload/01"
}
```
```

--------------------------------

### Get File Information - API

Source: https://lulustream.com/api.html/index

Retrieves detailed information about a specific file using its file code. Requires an API key. Supports querying multiple file codes separated by commas.

```bash
GET https://lulustream.com/api/file/info?key=455utteiegakw78e8&file_code=**{file_code}**
```

--------------------------------

### Get Folder List (API)

Source: https://lulustream.com/api.html/index

Retrieves a list of folders and files within a specified folder. Requires an API key and optionally a folder ID and a flag to include files.

```http
GET https://lulustream.com/api/folder/list?key=455utteiegakw78e8&fld_id=**{fld_id}**&files=1
```

--------------------------------

### GET /api/folder/edit

Source: https://lulustream.com/api.html/index

Updates folder details such as name, description, or parent folder. Skipped fields will not be updated.

```APIDOC
## GET /api/folder/edit

### Description
Updates folder details such as name, description, or parent folder. Skipped fields will not be updated.

### Method
GET

### Endpoint
https://lulustream.com/api/folder/edit

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **fld_id** (INT) - Required - Folder ID
- **name** (STRING) - Optional - New folder name
- **parent_id** (INT) - Optional - New parent Folder ID
- **descr** (STRING) - Optional - New folder description

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "fld_id": 25,
  "name": "Movies 2021",
  "parent_id": 0,
  "descr": "old stuff"
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (STRING) - Indicates success, usually "true"

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-18 21:21:44",
  "status": 200,
  "result": "true"
}
```
```

--------------------------------

### Get Upload Server URL

Source: https://lulustream.com/api.html/index

Retrieves the URL for the upload server. This URL is used as the target for file uploads. Requires an API key.

```HTTP
GET https://lulustream.com/api/upload/server?key=455utteiegakw78e8
```

--------------------------------

### Get Account Stats

Source: https://lulustream.com/api.html/index

Fetches account statistics, including various metrics like downloads, views, and profit, for a specified number of past days. Requires an API key.

```HTTP
GET https://lulustream.com/api/account/stats?key=455utteiegakw78e8&last=14
```

--------------------------------

### GET /api/file/encodings

Source: https://lulustream.com/api.html/index

Retrieves the status of current file encoding queues. You can filter the results by a specific file code.

```APIDOC
## GET /api/file/encodings

### Description
Retrieves the status of current file encoding queues. You can filter the results by a specific file code.

### Method
GET

### Endpoint
https://lulustream.com/api/file/encodings

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **file_code** (STRING) - Optional - Filter by File code

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "file_code": "fb5asfuj2snh"
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (ARRAY) - List of encoding jobs
  - **link** (STRING) - Link to the file
  - **progress** (INT) - Encoding progress percentage
  - **status** (STRING) - Current status (e.g., "ENCODING", "PENDING")
  - **title** (STRING) - Title of the file
  - **file_code** (STRING) - Unique file identifier
  - **quality** (STRING) - Encoding quality (e.g., "h" for high, "l" for low)

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-18 21:44:09",
  "status": 200,
  "result": [
    {
      "link": "http://lulustream.com/fb5asfuj2snh.html",
      "progress": 15,
      "status": "ENCODING",
      "title": "Test video",
      "quality": "h",
      "file_code": "fb5asfuj2snh"
    },
    {
      "link": "http://lulustream.com/fb5asfuj2snh.html",
      "progress": 0,
      "status": "PENDING",
      "title": "Test video",
      "quality": "l",
      "file_code": "fb5asfuj2snh"
    }
  ]
}
```
```

--------------------------------

### Get File Encodings Status (API)

Source: https://lulustream.com/api.html/index

Retrieves the current encoding queues for files. Requires an API key and optionally a file code to filter results.

```http
GET https://lulustream.com/api/file/encodings?key=455utteiegakw78e8
```

--------------------------------

### GET /api/file/deleted

Source: https://lulustream.com/api.html/index

Retrieves a list of recently deleted files. You can filter the results by specifying the number of hours to look back.

```APIDOC
## GET /api/file/deleted

### Description
Retrieves a list of recently deleted files. You can filter the results by specifying the number of hours to look back.

### Method
GET

### Endpoint
https://lulustream.com/api/file/deleted

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **last** (INT) - Optional - Show files deleted in last X hours

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "last": 24
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (ARRAY) - List of deleted files
  - **file_code** (STRING) - Unique file identifier
  - **deleted_by** (STRING) - User who deleted the file
  - **deleted_ago_sec** (STRING) - Time since deletion in seconds
  - **deleted** (STRING) - Timestamp of deletion
  - **title** (STRING) - Title of the deleted file

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-15 19:04:06",
  "status": 200,
  "result": [
    {
      "file_code": "38j4wvxw164d",
      "deleted_by": "me",
      "deleted_ago_sec": "40",
      "deleted": "2021-08-15 19:03:26",
      "title": "Video 109779195"
    }
  ]
}
```
```

--------------------------------

### GET /api/folder/list

Source: https://lulustream.com/api.html/index

Retrieves a list of folders and files within a specified parent folder. By default, it lists subfolders and files from the root folder.

```APIDOC
## GET /api/folder/list

### Description
Retrieves a list of folders and files within a specified parent folder. By default, it lists subfolders and files from the root folder.

### Method
GET

### Endpoint
https://lulustream.com/api/folder/list

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **fld_id** (INT) - Optional - Parent folder ID, default=0
- **files** (INT) - Optional - Show file list in this folder, 1 to show files, default=0

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "fld_id": 25,
  "files": 1
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (OBJECT)
  - **folders** (ARRAY) - List of subfolders
    - **name** (STRING) - Folder name
    - **fld_id** (STRING) - Folder identifier
    - **code** (STRING) - Folder code
  - **files** (ARRAY) - List of files in the folder
    - **thumbnail** (STRING) - URL to the file's thumbnail
    - **link** (STRING) - Direct link to the file
    - **file_code** (STRING) - Unique file identifier
    - **canplay** (INT) - Indicates if the file can be played (1 for yes, 0 for no)
    - **length** (STRING) - Duration of the file in seconds
    - **views** (STRING) - Number of views for the file
    - **uploaded** (STRING) - Timestamp of file upload
    - **public** (STRING) - Indicates if the file is public (1) or private (0)
    - **fld_id** (STRING) - Folder ID where the file is located
    - **title** (STRING) - Title of the file

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-15 19:54:22",
  "status": 200,
  "result": {
    "folders": [
      {
        "name": "Breaking Bad",
        "fld_id": "16",
        "code": "4pwb4yvp7v"
      },
      {
        "name": "Travis",
        "fld_id": "15",
        "code": "68dth39m76"
      }
    ],
    "files": [
      {
        "thumbnail": "http://img.lulustream.com/abnormamorph_t.jpg",
        "link": "http://lulustream.com/abnormamorph.html",
        "file_code": "abnormamorph",
        "canplay": 1,
        "length": "1560",
        "views": "10",
        "uploaded": "2021-08-20 20:37:22",
        "public": "0",
        "fld_id": "0",
        "title": "Tri pljus dva 2012 SATRip"
      }
    ]
  }
}
```
```

--------------------------------

### GET /api/file/url_uploads

Source: https://lulustream.com/api.html/index

Retrieves information about files being uploaded via URL. You can filter by file code and see the status and progress of each upload.

```APIDOC
## GET /api/file/url_uploads

### Description
Retrieves information about files being uploaded via URL. You can filter by file code and see the status and progress of each upload.

### Method
GET

### Endpoint
https://lulustream.com/api/file/url_uploads

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **file_code** (STRING) - Optional - Filter by File code

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "file_code": "fb5asfuj2snh"
}
```

### Response
#### Success Response (200)
- **requests_available** (INT) - Number of available upload requests
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (ARRAY) - List of URL upload jobs
  - **remote_url** (STRING) - The remote URL of the file to be uploaded
  - **progress** (INT) - Upload progress percentage
  - **status** (STRING) - Current status (e.g., "PENDING")
  - **file_code** (STRING) - Unique file identifier, if assigned
  - **fld_id** (STRING) - Folder ID where the file will be placed

#### Response Example
```json
{
  "requests_available": 2,
  "msg": "OK",
  "server_time": "2022-06-14 20:30:20",
  "status": 200,
  "result": [
    {
      "remote_url": "https://lulustream.com/1.mp4",
      "progress": 0,
      "status": "PENDING",
      "file_code": "",
      "fld_id": "0"
    },
    {
      "remote_url": "https://lulustream.com/2.mp4",
      "progress": 0,
      "status": "PENDING",
      "file_code": "xyayxm9ajlys",
      "fld_id": "7"
    }
  ]
}
```
```

--------------------------------

### GET /api/file/dmca

Source: https://lulustream.com/api.html/index

Retrieves a list of files scheduled for DMCA deletion. You can filter results by specifying the number of hours to look back for reported files.

```APIDOC
## GET /api/file/dmca

### Description
Retrieves a list of files scheduled for DMCA deletion. You can filter results by specifying the number of hours to look back for reported files.

### Method
GET

### Endpoint
https://lulustream.com/api/file/dmca

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **last** (INT) - Optional - Show files reported last X hours only

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "last": 24
}
```

### Response
#### Success Response (200)
- **msg** (STRING) - "OK"
- **server_time** (STRING) - Server time
- **status** (INT) - HTTP status code
- **result** (ARRAY) - List of DMCA scheduled files
  - **file_code** (STRING) - Unique file identifier
  - **del_in_sec** (STRING) - Time until deletion in seconds
  - **del_time** (STRING) - Scheduled deletion timestamp

#### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-08-15 19:31:48",
  "status": 200,
  "result": [
    {
      "file_code": "x2q5h0uhfzdu",
      "del_in_sec": "42097",
      "del_time": "2021-08-16 07:13:25"
    }
  ]
}
```
```

--------------------------------

### Get DMCA Scheduled Files List (API)

Source: https://lulustream.com/api.html/index

Retrieves a list of files scheduled for DMCA deletion. Requires an API key and an optional 'last' parameter to filter by reporting time.

```http
GET https://lulustream.com/api/file/dmca?key=455utteiegakw78e8&last=**{last}**
```

--------------------------------

### Get File URL Uploads Status (API)

Source: https://lulustream.com/api.html/index

Retrieves the status of files being uploaded via URL. Requires an API key and optionally a file code for filtering.

```http
GET https://lulustream.com/api/file/url_uploads?key=455utteiegakw78e8
```

--------------------------------

### Get Deleted Files List (API)

Source: https://lulustream.com/api.html/index

Retrieves a list of recently deleted files. Requires an API key and an optional 'last' parameter to specify the time window in hours for deleted files.

```http
GET https://lulustream.com/api/file/deleted?key=455utteiegakw78e8&last=**{last}**
```

--------------------------------

### Get File URL Uploads Status (API)

Source: https://lulustream.com/api.html/index

Retrieves the status of current file URL uploads and available requests. Supports filtering by restart or delete options for failed uploads. Requires an API key for authentication.

```http
GET https://lulustream.com/api/file/url_actions?key=455utteiegakw78e8
```

--------------------------------

### Create Folder (API)

Source: https://lulustream.com/api.html/index

Creates a new folder within the file system. Requires an API key, a folder name, and the parent folder ID.

```http
GET https://lulustream.com/api/folder/create?key=455utteiegakw78e8&name=**{name}**&parent_id=**{parent_id}**
```

--------------------------------

### Clone File - API

Source: https://lulustream.com/api.html/index

Creates a copy of an existing file. Requires an API key and the source file code. Optionally, a new title and target folder can be specified.

```bash
GET https://lulustream.com/api/file/clone?key=455utteiegakw78e8&file_code=**{file_code}**
```

--------------------------------

### Account Info API

Source: https://lulustream.com/api.html/index

Retrieves the account information, including total files, storage usage, login details, email, premium status, and balance.

```APIDOC
## GET /api/account/info

### Description
Retrieves the account information, including total files, storage usage, login details, email, premium status, and balance.

### Method
GET

### Endpoint
/api/account/info

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key

### Request Example
```
https://lulustream.com/api/account/info?key=455utteiegakw78e8
```

### Response
#### Success Response (200)
- **msg** (STRING) - Message indicating success.
- **server_time** (STRING) - Server time.
- **status** (INT) - HTTP status code.
- **result** (OBJECT) - Object containing account details:
  - **files_total** (STRING) - Total number of files.
  - **storage_left** (INT) - Storage space left in bytes.
  - **login** (STRING) - User login name.
  - **email** (STRING) - User email address.
  - **premium_expire** (STRING) - Premium expiration date.
  - **balance** (STRING) - Account balance.
  - **premium** (INT) - Premium status (1 for premium, 0 for non-premium).
  - **storage_used** (STRING) - Storage space used in bytes.

#### Response Example
```json
{
    "msg": "OK",
    "server_time": "2021-09-11 04:30:07",
    "status": 200,
    "result": {
        "files_total":"31",
        "storage_left":1288483337,
        "login":"megauploader21",
        "email": "megauploader21@gmail.com",
        "premium_expire":"2022-10-15 04:46:59",
        "balance":"108.00000",
        "premium":1,
        "storage_used":"685101"
    }
}
```
```

--------------------------------

### List Files - API

Source: https://lulustream.com/api.html/index

Fetches a list of files, with options to filter by folder, title, upload time, public/private status, and adult content. Supports pagination.

```bash
GET https://lulustream.com/api/file/list?key=455utteiegakw78e8
```

--------------------------------

### File Clone API

Source: https://lulustream.com/api.html/index

Creates a copy of an existing video file. Allows specifying a new title and target folder.

```APIDOC
## File Clone

### Description
Creates a duplicate (clone) of an existing video file. You can optionally provide a new title for the cloned file and specify a different folder to place it in.

### Method
GET

### Endpoint
`https://lulustream.com/api/file/clone?key={key}&file_code={file_code}`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key.
- **file_code** (STRING) - Required - The file code of the source file to clone.
- **file_title** (STRING) - Optional - The desired title for the new cloned file.
- **fld_id** (INT) - Optional - The ID of the folder where the cloned file should be placed.

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "file_code": "abnormamorph",
  "file_title": "New video title",
  "fld_id": 5
}
```

### Response
#### Success Response (200)
Returns the URL and file code for the newly created cloned file.
```json
{
  "msg": "OK",
  "server_time": "2021-08-14 19:39:58",
  "status": 200,
  "result": {
    "url": "http://lulustream.com/u405p6qz5xpi",
    "filecode": "u405p6qz5xpi"
  }
}
```
```

--------------------------------

### Upload File by URL

Source: https://lulustream.com/api.html/index

Initiates an upload process for a file located at a given URL. The API returns a future filecode upon successful initiation. Requires API key and the URL of the file to upload.

```HTTP
GET https://lulustream.com/api/upload/url?key=455utteiegakw78e8&url=**{url}**
```

--------------------------------

### Upload Subtitle via URL - API

Source: https://lulustream.com/api.html/index

Allows uploading subtitle files by providing a URL. Requires an API key, file code, and subtitle language. Optionally, a subtitle file can be attached directly.

```bash
curl -X POST -F 'key=455utteiegakw78e8' -F 'file_code=cnypqbf2t79l' -F 'sub_lang=eng' -F 'sub_file=@1.vtt' https://lulustream.com/api/upload/sub
```

--------------------------------

### Upload File via HTML Form

Source: https://lulustream.com/api.html/index

Demonstrates how to upload a file using an HTML form. This includes specifying the API key, redirect behavior, and the file itself. The form posts to the upload server URL.

```HTML
<form method="POST" enctype="multipart/form-data" action="https://s1.myvideo.com/upload/01">
		<input type="hidden" name="key" value="455utteiegakw78e8">
		<input type="hidden" name="html_redirect" value="1">
		<input type="file" name="file">
		<input type="submit">
		</form>
```

--------------------------------

### File Info API

Source: https://lulustream.com/api.html/index

Retrieves information about one or more video files using their file codes.

```APIDOC
## File Info

### Description
Retrieves detailed information about specific video files using their unique file codes. You can query multiple file codes by separating them with a comma.

### Method
GET

### Endpoint
`https://lulustream.com/api/file/info?key={key}&file_code={file_code}`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key.
- **file_code** (STRING) - Required - The file code or a comma-separated list of file codes.

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "file_code": "gi4o0tlro01u,gi4o0tlro012"
}
```

### Response
#### Success Response (200)
Returns an array of file objects, each containing detailed information like views, category, player image, status, and more.
```json
{
  "msg": "OK",
  "server_time": "2021-08-12 21:10:07",
  "status": 200,
  "result": [
    {
      "file_views_full": "0",
      "cat_id": "3",
      "player_img": "http://img.lulustream.com/fb5asfuj2snh.jpg",
      "status": 200,
      "file_code": "fb5asfuj2snh",
      "file_last_download": "2021-08-12 20:56:54",
      "canplay": 1,
      "file_public": "1",
      "file_length": "60",
      "file_title": "big buck bunny",
      "file_views": "0",
      "file_created": "2021-08-102 20:51:52",
      "file_premium_only": "0",
      "file_adult": "1",
      "file_fld_id": "25",
      "tags": "promo, high quality"
    }
  ]
}
```
```

--------------------------------

### Upload File by URL API

Source: https://lulustream.com/api.html/index

Initiates an upload of a video file from a given URL. The API returns a future filecode that will be valid once the upload is complete.

```APIDOC
## GET /api/upload/url

### Description
Initiates an upload of a video file from a given URL. The API returns a future filecode that will be valid once the upload is complete.

### Method
GET

### Endpoint
/api/upload/url

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **url** (STRING) - Required - URL to the video file
- **fld_id** (INT) - Optional - Folder ID
- **cat_id** (INT) - Optional - Category ID
- **file_public** (INT) - Optional - Public flag (1 for public, 0 for private)
- **file_adult** (INT) - Optional - Adult flag (1 for adult content, 0 otherwise)
- **tags** (STRING) - Optional - Tags list (comma-separated)

### Request Example
```
https://lulustream.com/api/upload/url?key=455utteiegakw78e8&url=http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4&fld_id=25&cat_id=5
```

### Response
#### Success Response (200)
- **msg** (STRING) - Message indicating success.
- **server_time** (STRING) - Server time.
- **status** (INT) - HTTP status code.
- **result** (OBJECT) - Object containing the future filecode:
  - **filecode** (STRING) - The filecode for the upload, which will be valid after completion.

#### Response Example
```json
{
    "msg":"OK",
    "server_time":"2021-08-12 20:56:47",
    "status":200,
    "result":{
        "filecode":"fb5asfuj2snh"
    }
}
```
```

--------------------------------

### Account Stats API

Source: https://lulustream.com/api.html/index

Retrieves account statistics, such as downloads, views, sales, and profit, for a specified period.

```APIDOC
## GET /api/account/stats

### Description
Retrieves account statistics, such as downloads, views, sales, and profit, for a specified period.

### Method
GET

### Endpoint
/api/account/stats

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key
- **last** (INT) - Optional - Show stats for the last X days (default: 7)

### Request Example
```
https://lulustream.com/api/account/stats?key=455utteiegakw78e8&last=14
```

### Response
#### Success Response (200)
- **msg** (STRING) - Message indicating success.
- **server_time** (STRING) - Server time.
- **status** (INT) - HTTP status code.
- **result** (ARRAY) - Array of statistics objects for each day:
  - **downloads** (STRING) - Number of downloads.
  - **profit_views** (STRING) - Profit from views.
  - **views_adb** (STRING) - Views from ads.
  - **sales** (STRING) - Number of sales.
  - **profit_sales** (STRING) - Profit from sales.
  - **profit_refs** (STRING) - Profit from referrals.
  - **profit_site** (STRING) - Profit from the site.
  - **views** (STRING) - Total views.
  - **refs** (STRING) - Number of referrals.
  - **day** (STRING) - Date of the statistics (YYYY-MM-DD).
  - **profit_total** (STRING) - Total profit.
  - **views_prem** (STRING) - Premium views.

#### Response Example
```json
{
    "msg": "OK",
    "server_time": "2021-09-13 04:30:07",
    "status": 200,
    "result": [
        {
          "downloads": "0",
          "profit_views": "0.00000",
          "views_adb": "1",
          "sales": "0",
          "profit_sales": "0.00000",
          "profit_refs": "0.00000",
          "profit_site": "0.00000",
          "views": "0",
          "refs": "0",
          "day": "2021-09-12",
          "profit_total": "0.00000",
          "views_prem": "0"
        }
    ]
}
```
```

--------------------------------

### Edit File Metadata - API

Source: https://lulustream.com/api.html/index

Modifies metadata for a given file, such as title, description, category, and visibility. Requires an API key and the file code. Supports editing multiple files.

```bash
GET https://lulustream.com/api/file/edit?key=455utteiegakw78e8&file_code=**{file_code}**&file_title=**{file_title}**
```

--------------------------------

### File List API

Source: https://lulustream.com/api.html/index

Retrieves a list of video files, with options to filter by folder, title, upload date, and privacy/adult status.

```APIDOC
## File List

### Description
Retrieves a list of video files with various filtering and pagination options. You can filter by folder, title, upload time, public/private status, and adult content status.

### Method
GET

### Endpoint
`https://lulustream.com/api/file/list?key={key}`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key.
- **fld_id** (INT) - Optional - Filter by folder ID.
- **title** (STRING) - Optional - Filter videos by title.
- **created** (STRING) - Optional - Show videos uploaded after a specific timestamp or within a certain time frame (e.g., '2021-07-21 05:07:10' or '20' for 20 minutes ago).
- **public** (INT) - Optional - Filter by public (1) or private (0) videos. Leave empty to show all.
- **adult** (INT) - Optional - Filter by adult (1) or safe (0) videos. Leave empty to show all.
- **per_page** (INT) - Optional - Number of results per page (default is usually 50).
- **page** (INT) - Optional - Page number for pagination.

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "fld_id": 25,
  "public": 1,
  "adult": 0,
  "per_page": 50,
  "page": 2
}
```

### Response
#### Success Response (200)
Returns a list of files with details like thumbnail, link, file code, length, views, and uploaded date. Includes pagination information.
```json
{
  "msg": "OK",
  "server_time": "2021-08-13 20:35:18",
  "status": 200,
  "result": {
    "files": [
      {
        "thumbnail": "http://img.lulustream.com/fb5asfuj2snh_t.jpg",
        "link": "http://lulustream.com/fb5asfuj2snh.html",
        "file_code": "fb5asfuj2snh",
        "canplay": 1,
        "length": "60",
        "views": "0",
        "uploaded": "2021-07-12 20:56:54",
        "public": "0",
        "fld_id": "0",
        "title": "Test 123"
      }
    ],
    "results_total": 9,
    "pages": 9,
    "results": 1
  }
}
```
```

--------------------------------

### Upload File API

Source: https://lulustream.com/api.html/index

Uploads files to the LuluStream service. Supports various options for file details, folder, category, and privacy settings.

```APIDOC
## POST /upload/01 (Upload Server)

### Description
Uploads files to the LuluStream service. Supports various options for file details, folder, category, and privacy settings.

### Method
POST

### Endpoint
[Upload Server URL obtained from /api/upload/server]

### Parameters
#### Form Data
- **key** (STRING) - Required - API key
- **file** (FILE) - Required - Video file(s) to upload
- **file_title** (STRING) - Optional - Title of the video
- **file_descr** (STRING) - Optional - Description of the video
- **snapshot** (FILE) - Optional - Custom video snapshot (up to 300KB)
- **fld_id** (INT) - Optional - Folder ID
- **cat_id** (INT) - Optional - Category ID
- **tags** (STRING) - Optional - Tags list (comma-separated)
- **file_public** (INT) - Optional - Public flag (1 for public, 0 for private)
- **file_adult** (INT) - Optional - Adult flag (1 for adult content, 0 otherwise)
- **html_redirect** (INT) - Optional - Use old style HTML redirect output instead of JSON (1 for true, 0 for false)

### Request Example
#### HTML Form Upload
```html
<form method="POST" enctype="multipart/form-data" action="[Upload Server URL]">
    <input type="hidden" name="key" value="455utteiegakw78e8">
    <input type="hidden" name="html_redirect" value="1">
    <input type="file" name="file">
    <input type="submit">
</form>
```
#### cURL File Upload (Multiple Files)
```bash
curl -X POST -F 'key=455utteiegakw78e8' -F 'file=@1.avi' -F 'file=@2.avi' [Upload Server URL]
```
#### cURL File Upload (with title and snapshot)
```bash
curl -X POST -F 'key=1l5ftrilhllgwx2bo' -F 'file_title="Hola!"' -F 'file=@1.avi' -F 'snapshot=@1.jpg' [Upload Server URL]
```

### Response
#### Success Response (200)
- **msg** (STRING) - Message indicating success.
- **status** (INT) - HTTP status code.
- **files** (ARRAY) - Array of uploaded file details:
  - **filecode** (STRING) - Unique code for the uploaded file.
  - **filename** (STRING) - Original filename.
  - **status** (STRING) - Upload status (e.g., "OK").

#### Response Example
```json
{
    "msg": "OK",
    "status": 200,
    "files": [{
        "filecode": "u9150wqzvhxj",
        "filename": "1.avi",
        "status": "OK"
    }, {
        "filecode": "gzky98gfg6hn",
        "filename": "2.avi",
        "status": "OK"
    }]
}
```
```

--------------------------------

### Edit Folder Details (API)

Source: https://lulustream.com/api.html/index

Updates the details of an existing folder, such as its name or parent folder. Requires an API key and the folder ID, with optional parameters for name, parent_id, and description.

```http
GET https://lulustream.com/api/folder/edit?key=455utteiegakw78e8&fld_id=**{fld_id}**&name=**{name}**
```

--------------------------------

### File Edit API

Source: https://lulustream.com/api.html/index

Allows editing of file metadata such as title, description, category, and privacy settings.

```APIDOC
## File Edit

### Description
Edits metadata for one or more video files, including title, description, category, folder, and privacy settings. Supports editing multiple files by providing comma-separated file codes.

### Method
GET

### Endpoint
`https://lulustream.com/api/file/edit?key={key}&file_code={file_code}`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key.
- **file_code** (STRING) - Required - The file code or a comma-separated list of file codes to edit.
- **file_title** (STRING) - Optional - The new title for the file.
- **file_descr** (STRING) - Optional - The new description for the file.
- **cat_id** (INT) - Optional - The new category ID for the file.
- **file_fld_id** (INT) - Optional - The new folder ID for the file.
- **file_public** (INT) - Optional - Set to 1 for public, 0 for private.
- **file_adult** (INT) - Optional - Set to 1 for adult content, 0 for safe content.
- **tags** (STRING) - Optional - New tags for the file, separated by commas.

### Request Example
```json
{
  "key": "455utteiegakw78e8",
  "file_code": "gi4o0tlro01u,hqpibyqwxumrt",
  "file_title": "The 100 S01E02",
  "file_descr": "release by MegaDrive",
  "cat_id": 5,
  "file_public": 1,
  "file_adult": 0,
  "tags": "promo, high quality"
}
```

### Response
#### Success Response (200)
Returns a success message and server time, indicating that the file metadata has been updated.
```json
{
  "msg": "OK",
  "server_time": "2021-08-13 20:17:12",
  "status": 200,
  "result": "true"
}
```
```
Tokens:
Raw