### File List Parameters Example

Source: https://filemoon.sx/api-docs

Example parameters for the file list endpoint, demonstrating filtering by folder and title.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
file_code| Single filecode or a comma-separated list of filecodes.| gi4o0tlro01u,gi4o0tlro012| STRING| Yes
```

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

### File List Sample Response Example

Source: https://filemoon.sx/api-docs

Sample JSON response for the file list endpoint with specific file codes.

```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:28:53",
    "status": 200,
    "result": [
        {
            "status": 200,
            "file_code": "gi4o0tlro01u",
            "name": "4K Time Lapse in the EOS 6D Mark II",
            "canplay": 1,
            "views_started": "1",
            "views": "0",
            "length": "20",
            "uploaded": "2017-08-10 05:07:17"
        },
        {
            "status": 404,
            "file_code": "gi4o0tlro012"
        }
    ]
}
```

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

### Get Account Stats

Source: https://filemoon.sx/api-docs

Summarizes performance metrics such as downloads, profit, and referrals. An optional 'last' parameter can specify the number of past days to include.

```json
{
  "msg": "OK",
  "server_time": "2017-08-11 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": "2017-09-12",
      "profit_total": "0.00000",
      "views_prem": "0"
    }
  ]
}
```

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

### Upload File to Server

Source: https://filemoon.sx/api-docs

Post your file with all required parameters to the upload server obtained from the 'Get Upload Server' endpoint. Requires an API key and the file itself.

```json
{
    "msg": "OK",
    "status": 200,
    "files": [ { 
        "filecode":"tnklyibwwpsh",
        "filename": "qwbs4m4ze4j4.mp4",
        "status": "OK" } ]
}
```

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

### Remote Subtitles JSON Manifest Example

Source: https://filemoon.sx/api-docs

This is a sample JSON structure for a remote subtitle manifest, specifying VTT file URLs and labels. The 'default' flag is optional.

```json
[{"src":"http://yoursubtitle.com/file.vtt","label":"Language1",default:true},{"src":"http://yoursubtitle.com/file2.vtt","label":"Language2"}]
```

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

### Get Account Info

Source: https://filemoon.sx/api-docs

Retrieve metadata about the current account, including quotas and premium status. Requires an API key.

```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:30:07",
    "status": 200,
    "result": {
        "email": "user@example.com",
        "balance": "0.00000",
        "storage_used" :"24186265",
        "storage_left": 128824832615,
        "premim_expire": "2015-10-24 21:00:00"
    }
}
```

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

### Get Upload Server

Source: https://filemoon.sx/api-docs

Retrieves the optimal upload endpoint for the current account.

```APIDOC
## Get Upload Server

### Description
Retrieves the optimal upload endpoint for the current account.

### Method
GET

### Endpoint
`https://api.byse.sx/upload/server`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (STRING)

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

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

### Get Embed Domain

Source: https://filemoon.sx/api-docs

Returns the legacy and current embed domains.

```APIDOC
## Get Embed Domain

### Description
Returns the legacy and current embed domains.

### Method
GET

### Endpoint
`https://api.byse.sx/get/domain`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.

### Response
#### Success Response (200)
- **old_domain** (STRING)
- **new_domain** (STRING)
- **status** (INTEGER)
- **server_time** (STRING)

### Response Example
```json
{
  "old_domain": "filemoon.sx",
  "new_domain": "blablabla_embed_domain.com",
  "status": 200,
  "server_time": "2024-12-03 08:32:03"
}
```
```

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

### Get HLS Link

Source: https://filemoon.sx/api-docs

Generates a time-limited HLS playback URL when premium streaming is enabled.

```APIDOC
## Get HLS Link

### Description
Generates a time-limited HLS playback URL when premium streaming is enabled.

### Method
GET

### Endpoint
`https://api.byse.sx/hls/link`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **ip** (STRING) - Required - IPv4 address of the viewer.
- **ua** (STRING) - Required - URL-encoded user agent of the viewer.

### Response
#### Success Response (200)
- **server_time** (STRING)
- **result** (STRING) - The HLS playback URL.
- **status** (INTEGER)
- **msg** (STRING)

### Response Example
```json
{
  "server_time": "2025-02-20 06:57:03",
  "result": "https://premium.api.byse.sx/hls2/01/08264/2231iyrBNMfj_h/master.m3u8?t=okJkln83voSDg20Gm7Mb9givk-7ci9Z7MDazB5GE&s=1740034623&e=7200&f=54321623&srv=122&asn=12192&sp=4000&p=1",
  "status": 200,
  "msg": "OK"
}
```
```

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

### Get Upload Server

Source: https://filemoon.sx/api-docs

Retrieves the optimal upload endpoint for the current account. This endpoint is necessary before initiating a file upload.

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

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

### Create Folder Parameters

Source: https://filemoon.sx/api-docs

Parameters for creating a new folder, including name, parent ID, and an optional description.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
name| Folder name.| New Videos| STRING| Yes
parent_id| Identifier of the parent folder (0 for root).| 0| INT| Optional
descr| Optional description for the folder.| new stuff| STRING| Optional
```

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

### Sample Response for Playback Progress Events

Source: https://filemoon.sx/api-docs

This is a sample JSON payload for a 'byse-progress' event, detailing playback progress and video duration.

```json
{
  "type": "byse-progress",
  "file_code": "gi4o0tlro01u",
  "progress": 42.75,
  "timestamp": 128.4,
  "duration": 300.5
}
```

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

### File Set Folder Sample Response

Source: https://filemoon.sx/api-docs

Sample JSON response for the file set folder endpoint, confirming the move operation.

```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:28:53",
    "status": 200
}
```

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

### Folder List Sample Response

Source: https://filemoon.sx/api-docs

Sample JSON response for the folder list endpoint, showing nested folders and files.

```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.xvs.tt/04nolnuszhph_t.jpg",
                "link": "http://xvs.tt/04nolnuszhph.html",
                "file_code": "04nolnuszhph",
                "canplay": 1,
                "length": "1560",
                "views": "10",
                "uploaded": "2021-08-20 20:37:22",
                "public": "0",
                "fld_id": "0",
                "title": "Tri pljus dva 2012 SATRip"
            }
        ]
    }
}
```

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

### Folder List Parameters

Source: https://filemoon.sx/api-docs

Parameters for listing folders, with options to specify a parent folder and include file listings.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
fld_id| Parent folder identifier. Defaults to 0 (root).| 25| INT| Optional
files| Set to 1 to include file listings.| 1| INT| Optional
```

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

### Sample Response for File Operations

Source: https://filemoon.sx/api-docs

This is a sample JSON response structure for successful file operations.

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

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

### File List Parameters

Source: https://filemoon.sx/api-docs

Parameters for listing files, including filtering by folder, title, creation date, and visibility.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
fld_id| Folder identifier. Default is root (0).| 25| INT| Optional
title| Filter video titles.| Iron man| STRING| Optional
created| Only return files uploaded after the timestamp. Provide a number to limit to uploads within the last X minutes.| 2018-06-21 05:07:10| STRING| Optional
public| Show only public (1) or private (0) files.| 1| INT| Optional
per_page| Number of results per page.| 20| INT| Optional
page| Page number to return.| 2| INT| Optional
```

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

### Create Folder

Source: https://filemoon.sx/api-docs

Creates a new folder in the specified parent. Requires an API key and a folder name.

```APIDOC
## GET /folder/create

### Description
Creates a new folder in the specified parent.

### Method
GET

### Endpoint
`https://api.byse.sx/folder/create`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **name** (STRING) - Required - Folder name.
- **parent_id** (INT) - Optional - Identifier of the parent folder (0 for root).
- **descr** (STRING) - Optional - Optional description for the folder.

### Response
#### Success Response (200)
- (No specific fields mentioned in the sample response, implies a success status)

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

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:28:53",
  "status": 200
}
```
```

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

### File List Sample Response

Source: https://filemoon.sx/api-docs

Sample JSON response for the file list endpoint, showing file details and status.

```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:28:53",
  "status": 200,
  "result": [
    {
      "status": 200,
      "filecode": "gi4o0tlro01u",
      "name": "4K Time Lapse in the EOS 6D Mark II",
      "canplay": 1,
      "views_started": "1",
      "views": "0",
      "length": "20",
      "uploaded": "2017-08-10 05:07:17"
    },
    {
      "status": 404,
      "filecode": "gi4o0tlro012"
    }
  ]
}
```

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

### Video Preview

Source: https://filemoon.sx/api-docs

Returns URLs to preview sprites and associated VTT tracks.

```APIDOC
## Video Preview

### Description
Returns URLs to preview sprites and associated VTT tracks.

### Method
GET

### Endpoint
`https://api.byse.sx/images/preview`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Optional - File code to fetch preview assets for.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)
  - **previews** (ARRAY)
    - **sprite** (STRING)
    - **vtt** (STRING)

### Response Example
```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:29:54",
    "status": 200,
    "result": {
        "previews": [
            {
                "sprite": "https://img-place.com/preview_sprite.png",
                "vtt": "https://img-place.com/preview.vtt"
            }
        ]
    }
}
```
```

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

### File Set Folder Parameters

Source: https://filemoon.sx/api-docs

Parameters for moving a file to a different folder, including file code and destination folder ID.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
file_code| Filecode to move.| gi4o0tlro01u| STRING| Yes
fld_id| Destination folder ID.| 15| INT| Yes
```

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

### File List

Source: https://filemoon.sx/api-docs

Lists files with optional filters for folder, visibility, and creation date. Requires an API key.

```APIDOC
## GET /file/list

### Description
Lists files with optional filters for folder, visibility, and creation date.

### Method
GET

### Endpoint
`https://api.byse.sx/file/list`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **fld_id** (INT) - Optional - Folder identifier. Default is root (0).
- **title** (STRING) - Optional - Filter video titles.
- **created** (STRING) - Optional - Only return files uploaded after the timestamp. Provide a number to limit to uploads within the last X minutes.
- **public** (INT) - Optional - Show only public (1) or private (0) files.
- **per_page** (INT) - Optional - Number of results per page.
- **page** (INT) - Optional - Page number to return.

### Response
#### Success Response (200)
- **status** (INT) - Status code for the file entry.
- **filecode** (STRING) - The unique file code.
- **name** (STRING) - The name of the file.
- **canplay** (INT) - Indicates if the file can be played.
- **views_started** (STRING) - Number of times playback has started.
- **views** (STRING) - Total number of views.
- **length** (STRING) - The duration of the file in seconds.
- **uploaded** (STRING) - The timestamp when the file was uploaded.

### Request Example
```json
{
  "key": "1l5ftrilhllgwx2bo",
  "fld_id": 25,
  "title": "Iron man"
}
```

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:28:53",
  "status": 200,
  "result": [
    {
      "status": 200,
      "filecode": "gi4o0tlro01u",
      "name": "4K Time Lapse in the EOS 6D Mark II",
      "canplay": 1,
      "views_started": "1",
      "views": "0",
      "length": "20",
      "uploaded": "2017-08-10 05:07:17"
    },
    {
      "status": 404,
      "filecode": "gi4o0tlro012"
    }
  ]
}
```
```

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

### File Clone Sample Response

Source: https://filemoon.sx/api-docs

Sample JSON response for the file clone endpoint, including the new file code and URL.

```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:28:53",
    "status": 200,
    "result": {
        "file_code": "gtl2mhgw4is7",
        "url": "https://api.byse.sx/d/gtl2mhgw4is7"
    }
}
```

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

### Sample Response for DMCA Files

Source: https://filemoon.sx/api-docs

This JSON response lists files currently queued for DMCA removal, including removal time.

```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"
        }
    ]
}
```

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

### File Clone Parameters

Source: https://filemoon.sx/api-docs

Parameters for cloning a file, requiring the API key and the file code to be cloned.

```text
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes
file_code| Filecode to clone.| gi4o0tlro01u| STRING| Yes
```

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

### Upload To Server

Source: https://filemoon.sx/api-docs

Post your file with all required params to the upload server returned above.

```APIDOC
## Upload To Server

### Description
Post your file with all required params to the upload server returned above.

### Method
POST

### Endpoint
`https://moon-upload-server-01.filemoon.to/upload/01`

### Parameters
#### Form Data
- **key** (STRING) - Required - API key associated with the account.
- **file** (FILE) - Required - Video file to upload.

### Request Example
```json
{
  "key": "1l5ftrilhllgwx2bo",
  "file": "xxxx.mp4"
}
```

### Response
#### Success Response (200)
- **msg** (STRING)
- **status** (INTEGER)
- **files** (ARRAY)
  - **filecode** (STRING)
  - **filename** (STRING)
  - **status** (STRING)

### Response Example
```json
{
    "msg": "OK",
    "status": 200,
    "files": [ { 
        "filecode":"tnklyibwwpsh",
        "filename": "qwbs4m4ze4j4.mp4",
        "status": "OK" } ]
}
```
```

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

### Account Stats

Source: https://filemoon.sx/api-docs

Summarises performance metrics such as downloads, profit, and referrals.

```APIDOC
## Account Stats

### Description
Summarises performance metrics such as downloads, profit, and referrals.

### Method
GET

### Endpoint
`https://api.byse.sx/account/stats`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **last** (STRING) - Optional - Show stats for the last X days (default 7).

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (ARRAY)
  - **downloads** (STRING)
  - **profit_views** (STRING)
  - **views_adb** (STRING)
  - **sales** (STRING)
  - **profit_sales** (STRING)
  - **profit_refs** (STRING)
  - **profit_site** (STRING)
  - **views** (STRING)
  - **refs** (STRING)
  - **day** (STRING)
  - **profit_total** (STRING)
  - **views_prem** (STRING)

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 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": "2017-09-12",
      "profit_total": "0.00000",
      "views_prem": "0"
    }
  ]
}
```
```

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

### File Info

Source: https://filemoon.sx/api-docs

Returns detailed metadata for one or more files.

```APIDOC
## File Info

### Description
Returns detailed metadata for one or more files.

### Method
GET

### Endpoint
`https://api.byse.sx/file/info`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
    "email": "user@example.com",
    "balance": "0.00000",
    "storage_used" :"24186265",
    "storage_left": 128824832615,
    "premim_expire": "2015-10-24 21:00:00"
  }
}
```
```

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

### Sample Response for Deleted Files

Source: https://filemoon.sx/api-docs

This JSON response lists recently deleted files, including their deletion status and time.

```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"
        }
    ]
}
```

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

### Folder List

Source: https://filemoon.sx/api-docs

Lists folders and optionally files within a parent folder. Requires an API key.

```APIDOC
## GET /folder/list

### Description
Lists folders and (optionally) files within a parent folder.

### Method
GET

### Endpoint
`https://api.byse.sx/folder/list`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **fld_id** (INT) - Optional - Parent folder identifier. Defaults to 0 (root).
- **files** (INT) - Optional - Set to 1 to include file listings.

### Response
#### Success Response (200)
- **folders** (Array) - An array of folder objects, each with `name`, `fld_id`, and `code`.
- **files** (Array) - An array of file objects, each with details like `thumbnail`, `link`, `file_code`, `canplay`, `length`, `views`, `uploaded`, `public`, `fld_id`, and `title`.

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

### 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.xvs.tt/04nolnuszhph_t.jpg",
        "link": "http://xvs.tt/04nolnuszhph.html",
        "file_code": "04nolnuszhph",
        "canplay": 1,
        "length": "1560",
        "views": "10",
        "uploaded": "2021-08-20 20:37:22",
        "public": "0",
        "fld_id": "0",
        "title": "Tri pljus dva 2012 SATRip"
      }
    ]
  }
}
```
```

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

### Account Info

Source: https://filemoon.sx/api-docs

Returns metadata about the current account, including quotas and premium status.

```APIDOC
## Account Info

### Description
Returns metadata about the current account, including quotas and premium status.

### Method
GET

### Endpoint
`https://api.byse.sx/account/info`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)
  - **email** (STRING)
  - **balance** (STRING)
  - **storage_used** (STRING)
  - **storage_left** (INTEGER)
  - **premim_expire** (STRING)

### Response Example
```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:30:07",
    "status": 200,
    "result": {
        "email": "user@example.com",
        "balance": "0.00000",
        "storage_used" :"24186265",
        "storage_left": 128824832615,
        "premim_expire": "2015-10-24 21:00:00"
    }
}
```
```

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

### File Set Folder

Source: https://filemoon.sx/api-docs

Moves a file into the specified folder. Requires an API key, the file code, and the destination folder ID.

```APIDOC
## GET /file/set_folder

### Description
Moves a file into the specified folder.

### Method
GET

### Endpoint
`https://api.byse.sx/file/set_folder`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Required - Filecode to move.
- **fld_id** (INT) - Required - Destination folder ID.

### Response
#### Success Response (200)
- (No specific fields mentioned in the sample response, implies a success status)

### Request Example
```json
{
  "key": "1l5ftrilhllgwx2bo",
  "file_code": "gi4o0tlro01u",
  "fld_id": 15
}
```

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:28:53",
  "status": 200
}
```
```

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

### Playback Progress Events

Source: https://filemoon.sx/api-docs

Listens for playback progress signals emitted by the embed player via window.postMessage. Events are throttled and fire on play/pause transitions.

```APIDOC
## Player Events

### Playback Progress Events
`https://api.byse.sx/e/{file_code}`

When the embed player runs inside an iframe it reports playback progress to the parent window using window.postMessage. Listen for messages whose type is "byse-progress" to track how far each viewer has watched. Events are throttled to roughly one per second during playback and also fire on play/pause transitions.
Messages are posted to window.parent with target origin "*", so always confirm event.origin and the payload type before trusting the data. For rotating or nested embeds the event is forwarded up the frame chain so the outermost parent still receives it.

#### Parameters
Name| Description| Example| Format| Required  
---|---|---|---|---
type| Message identifier. Always "byse-progress" for progress events.| byse-progress| STRING| Yes  
file_code| File code of the video the event refers to.| gi4o0tlro01u| STRING| Yes  
progress| Percentage of the whole video watched (0–100, rounded to two decimals).| 42.75| FLOAT| Yes  
timestamp| Current playback position in seconds.| 128.4| FLOAT| Yes  
duration| Total video duration in seconds (0 until the player knows it).| 300.5| FLOAT| Yes  

#### Examples
Listen for progress on the parent page
```javascript
window.addEventListener('message', (event) => {
  const data = event.data;
  if (!data || data.type !== 'byse-progress') {
    return;
  }
  const { file_code, progress, timestamp, duration } = data;
  console.log(file_code, progress + '%', timestamp + '/' + duration + 's');
});
```

#### Sample response
```json
{
  "type": "byse-progress",
  "file_code": "gi4o0tlro01u",
  "progress": 42.75,
  "timestamp": 128.4,
  "duration": 300.5
}
```
```

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

### File Clone

Source: https://filemoon.sx/api-docs

Duplicates a file into the current account. Available when cloning is enabled. Requires an API key and the file code to clone.

```APIDOC
## GET /file/clone

### Description
Duplicates a file into the current account. Available when cloning is enabled.

### Method
GET

### Endpoint
`https://api.byse.sx/file/clone`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Required - Filecode to clone.

### Response
#### Success Response (200)
- **file_code** (STRING) - The file code of the newly cloned file.
- **url** (STRING) - The URL to access the cloned file.

### Request Example
```json
{
  "key": "1l5ftrilhllgwx2bo",
  "file_code": "gi4o0tlro01u"
}
```

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2017-08-11 04:28:53",
  "status": 200,
  "result": {
    "file_code": "gtl2mhgw4is7",
    "url": "https://api.byse.sx/d/gtl2mhgw4is7"
  }
}
```
```

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

### Encoding List

Source: https://filemoon.sx/api-docs

Lists all encoding tasks, including their current progress and statuses.

```APIDOC
## Encoding

### Encoding List
`https://api.byse.sx/encoding/list`

Lists all encoding tasks with their current progress and statuses.
```

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

### Remote Subtitles JSON

Source: https://filemoon.sx/api-docs

Loads multiple remote subtitles from a JSON manifest with optional default flags. The JSON manifest should contain VTT subtitle URLs.

```APIDOC
## Player

### Remote Subtitles JSON
`https://api.byse.sx/e/{file_code}?sub.info=http://yoursubtitle.com/def.json`

Load multiple remote subtitles from a JSON manifest with optional default flags.
Ensure the JSON is accessible with appropriate CORS headers and contains VTT subtitle URLs; default is optional and false if omitted.
#### Sample response
```json
[{"src":"http://yoursubtitle.com/file.vtt","label":"Language1",default:true},{"src":"http://yoursubtitle.com/file2.vtt","label":"Language2"}]
```
```

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

### Thumbnail Image

Source: https://filemoon.sx/api-docs

Returns the thumbnail URL for the provided file code.

```APIDOC
## Thumbnail Image

### Description
Returns the thumbnail URL for the provided file code.

### Method
GET

### Endpoint
`https://api.byse.sx/images/thumb`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Optional - File code to fetch artwork for.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)
  - **thumbnail** (STRING)

### Response Example
```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:29:54",
    "status": 200,
    "result": {
        "thumbnail": "https://img-place.com/as1xc34vv12x.png"
    }
}
```
```

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

### Restart Errors

Source: https://filemoon.sx/api-docs

Restarts encoding for a file that is currently in an error state.

```APIDOC
## Restart Errors

### Description
Restarts encoding for a file that is currently in an error state.

### Method
GET

### Endpoint
`https://api.byse.sx/encoding/restart`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Required - File code to restart.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)

### Response Example
```json
{
  "msg": "Encoding for file code: xxx12313mcmc was restarted",
  "server_time": "2021-12-08 10:53:45",
  "status": 200
}
```
```

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

### Splash Image

Source: https://filemoon.sx/api-docs

Retrieves the splash image URL for the given file.

```APIDOC
## Splash Image

### Description
Retrieves the splash image URL for the given file.

### Method
GET

### Endpoint
`https://api.byse.sx/images/splash`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Optional - File code to fetch artwork for.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)
  - **splash** (STRING)

### Response Example
```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:29:54",
    "status": 200,
    "result": {
        "splash": "https://img-place.com/as1xc34vv12x.png"
    }
}
```
```

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

### Remote Logo

Source: https://filemoon.sx/api-docs

Overlays a custom logo on the player. Supports .png or .jpg formats.

```APIDOC
## Player

### Remote Logo
`https://api.byse.sx/e/{file_code}?logo=http://yoursite.com/link/to.png`

Overlay a custom logo on the player (.png or .jpg).
```

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

### Listen for Playback Progress Events

Source: https://filemoon.sx/api-docs

This JavaScript code listens for 'byse-progress' messages from an iframe to track video playback. Always verify event origin and payload type.

```javascript
window.addEventListener('message', (event) => {
  const data = event.data;
  if (!data || data.type !== 'byse-progress') {
    return;
  }
  const { file_code, progress, timestamp, duration } = data;
  console.log(file_code, progress + '%', timestamp + '/' + duration + 's');
});
```

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

### Restart Encoding Errors Response

Source: https://filemoon.sx/api-docs

This JSON response confirms that the encoding process for a specified file code has been restarted.

```json
{
  "msg": "Encoding for file code: xxx12313mcmc was restarted",
  "server_time": "2021-12-08 10:53:45",
  "status": 200
}
```

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

### Add Remote Upload

Source: https://filemoon.sx/api-docs

Adds a remote download to the upload queue using a direct video URL.

```APIDOC
## Add Remote Upload

### Description
Adds a remote download to the upload queue using a direct video URL.

### Method
GET

### Endpoint
`https://api.byse.sx/remote/add`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **url** (STRING) - Optional - URL to the source video file.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT)
  - **filecode** (STRING)

### Response Example
```json
{
"msg": "OK",
"server_time": "2017-08-11 04:29:54",
"status": 200,
"result": {
    "filecode": "jthi5jdsu8t9"
  }
}
```
```

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

### Encoding Status Per File Response

Source: https://filemoon.sx/api-docs

This JSON response shows the encoding status for multiple files, including their quality, name, progress, status, and any errors encountered.

```json
{
  "msg": "OK",
  "server_time": "2021-12-08 10:53:45",
  "status": 200,
  "result": [
    {
      "quality": "X",
      "name": "This file title",
      "progress": 0,
      "status": "ERROR",
      "error": "File download failed:500",
      "file_code": "xx1234cccs"
    },
    {
      "file_code": "xx1234cccs",
      "quality": "H",
      "name": "This file title2",
      "progress": "91",
      "status": "ENCODING"
    }
  ]
}
```

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

### Add Remote Upload

Source: https://filemoon.sx/api-docs

Adds a remote download to the upload queue using a direct video URL. Returns a file code for tracking the upload status.

```json
{
"msg": "OK",
"server_time": "2017-08-11 04:29:54",
"status": 200,
"result": {
    "filecode": "jthi5jdsu8t9"
  }
}
```

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

### Remote Subtitle

Source: https://filemoon.sx/api-docs

Attaches a remote VTT subtitle to an embed by providing paired cX_file and cX_label parameters.

```APIDOC
## Player

### Remote Subtitle
`https://api.byse.sx/e/{file_code}?cX_file=https://example.com/file.vtt&cX_label=English`

Attach a remote VTT subtitle to an embed by providing paired cX_file and cX_label parameters (replace X with an index).

#### Parameters
Name| Description| Example| Format| Required  
---|---|---|---|---
cX_file| Subtitle file URL (c1_file, c2_file, etc.).| https://example.com/file.vtt| STRING| Yes  
cX_label| Label for the subtitle track (c1_label, c2_label, etc.).| English| STRING| Yes
```

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

### Encoding Status Per File

Source: https://filemoon.sx/api-docs

Returns encoding progress for a single file using its file code.

```APIDOC
## Encoding Status Per File

### Description
Returns encoding progress for a single file.

### Method
GET

### Endpoint
`https://api.byse.sx/encoding/status`

### Parameters
#### Query Parameters
- **key** (STRING) - Required - API key associated with the account.
- **file_code** (STRING) - Required - File code to inspect.

### Response
#### Success Response (200)
- **msg** (STRING)
- **server_time** (STRING)
- **status** (INTEGER)
- **result** (OBJECT) - Contains file encoding details.
  - **file_code** (STRING)
  - **quality** (STRING)
  - **name** (STRING)
  - **progress** (STRING)
  - **status** (STRING)

### Response Example
```json
{
  "msg": "OK",
  "server_time": "2021-12-08 10:53:45",
  "status": 200,
  "result": {
    "file_code": "xx1234cccs",
    "quality": "H",
    "name": "This file title2",
    "progress": "91",
    "status": "ENCODING"
  }
}
```
```

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

### Generate HLS Playback Link Response

Source: https://filemoon.sx/api-docs

This JSON response provides a time-limited HLS playback URL, generated for premium streaming, including playback parameters and server information.

```json
{
"server_time":"2025-02-20 06:57:03",
"result":"https://premium.api.byse.sx/hls2/01/08264/2231iyrBNMfj_h/master.m3u8?t=okJkln83voSDg20Gm7Mb9givk-7ci9Z7MDazB5GE&s=1740034623&e=7200&f=54321623&srv=122&asn=12192&sp=4000&p=1",
"status":200,
"msg":"OK"
}
```

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

### Thumbnail Image URL Response

Source: https://filemoon.sx/api-docs

This JSON response provides the URL for a thumbnail image associated with a specific file code.

```json
{
    "msg": "OK",
    "server_time": "2017-08-11 04:29:54",
    "status": 200,
    "result": {
        "thumbnail": "https://img-place.com/as1xc34vv12x.png"
    }
}
```

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

### Single File Encoding Status Response

Source: https://filemoon.sx/api-docs

This JSON response details the encoding status for a specific file, including its file code, quality, name, progress, and current status.

```json
{
  "msg": "OK",
  "server_time": "2021-12-08 10:53:45",
  "status": 200,
  "result": {
    "file_code": "xx1234cccs",
    "quality": "H",
    "name": "This file title2",
    "progress": "91",
    "status": "ENCODING"
  }
}
```

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

### DMCA Files

Source: https://filemoon.sx/api-docs

Retrieves files currently queued for DMCA removal. Supports filtering by the number of DMCA reports returned.

```APIDOC
## Files

### DMCA Files
`https://api.byse.sx/files/dmca`

Get files currently queued for DMCA removal.

#### Parameters
Name| Description| Example| Format| Required  
---|---|---|---|---
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes  
last| Limit the number of DMCA reports returned.| 20| INT| Optional  

#### Sample response
```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"
        }
    ]
}
```
```

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

### Deleted Files

Source: https://filemoon.sx/api-docs

Retrieves a list of the most recently deleted files for the account. Supports filtering by the number of deleted files returned.

```APIDOC
## Files

### Deleted Files
`https://api.byse.sx/files/deleted`

Get the most recently deleted files for the account.

#### Parameters
Name| Description| Example| Format| Required  
---|---|---|---|---
key| API key associated with the account.| 1l5ftrilhllgwx2bo| STRING| Yes  
last| Limit the number of deleted files returned.| 20| INT| Optional  

#### Sample response
```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"
        }
    ]
}
```
```

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

### Embed Domain Resolution Response

Source: https://filemoon.sx/api-docs

This JSON response returns both the legacy and current embed domains used by the platform.

```json
{
"old_domain":"filemoon.sx",
"new_domain":"blablabla_embed_domain.com",
"status":200,
"server_time":"2024-12-03 08:32:03"
}
```

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

### Remote Poster

Source: https://filemoon.sx/api-docs

Supplies a custom poster image for the embed player. Supports .png or .jpg formats.

```APIDOC
## Player

### Remote Poster
`https://api.byse.sx/e/{file_code}?poster=http://yoursite.com/link/to.png`

Supply a custom poster image for the embed player (.png or .jpg).
```