Maxcloud API Documentation

Get information about your account including storage usage, premium status, and balance.

GET https://api.maxcloud.com/v1/account/info?key=YOUR_API_KEY

{
  "status": "success",
  "data": {
    "login": "username123",
    "email": "[email protected]",
    "premium": true,
    "premium_expires": "2023-12-31",
    "storage_used": "685101",
    "storage_total": "2147483648",
    "balance": "108.50",
    "files_total": 31
  }
}

Get statistics about your account including views, downloads, and earnings.

GET https://api.maxcloud.com/v1/account/stats?key=YOUR_API_KEY&last=7

{
  "status": "success",
  "data": [
    {
      "date": "2023-06-01",
      "views": 125,
      "downloads": 42,
      "earnings": "5.25"
    },
    {
      "date": "2023-06-02",
      "views": 98,
      "downloads": 31,
      "earnings": "3.92"
    }
  ]
}

Get the optimal server for uploading files based on your location.

GET https://api.maxcloud.com/v1/upload/server?key=YOUR_API_KEY

{
  "status": "success",
  "server": "https://us1.maxcloud.com/upload"
}

Upload a file to Maxcloud storage. You can upload multiple files at once.

POST https://us1.maxcloud.com/upload

curl -X POST -H 'X-API_KEY: YOUR_API_KEY' -F '[email protected]' -F 'title=My Vacation Video' https://us1.maxcloud.com/upload

{
  "status": "success",
  "files": [
    {
      "id": "abc123def456",
      "name": "video.mp4",
      "size": 1024000,
      "url": "https://maxcloud.com/v/abc123def456"
    }
  ]
}

Upload a file to Maxcloud by providing a URL. The file will be downloaded from the specified URL.

GET https://api.maxcloud.com/v1/upload/url?key=YOUR_API_KEY&url=FILE_URL

{
  "status": "success",
  "file_id": "abc123def456",
  "status_url": "https://api.maxcloud.com/v1/file/abc123def456/status"
}

Get information about a specific file including metadata and statistics.

GET https://api.maxcloud.com/v1/file/info?key=YOUR_API_KEY&file_id=FILE_ID

{
  "status": "success",
  "file": {
    "id": "abc123def456",
    "name": "video.mp4",
    "size": 1024000,
    "views": 125,
    "downloads": 42,
    "earnings": "5.25",
    "created_at": "2023-06-01T12:00:00Z",
    "url": "https://maxcloud.com/v/abc123def456",
    "thumbnail": "https://maxcloud.com/t/abc123def456.jpg"
  }
}

Update metadata for a specific file.

POST https://api.maxcloud.com/v1/file/edit?key=YOUR_API_KEY&file_id=FILE_ID

{
  "status": "success",
  "message": "File updated successfully"
}

Get a list of all your files with pagination support.

GET https://api.maxcloud.com/v1/file/list?key=YOUR_API_KEY&page=1&per_page=10

{
  "status": "success",
  "files": [
    {
      "id": "abc123def456",
      "name": "video1.mp4",
      "size": 1024000,
      "views": 125,
      "created_at": "2023-06-01T12:00:00Z"
    },
    {
      "id": "def456ghi789",
      "name": "video2.mp4",
      "size": 2048000,
      "views": 98,
      "created_at": "2023-06-02T12:00:00Z"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "per_page": 10,
    "pages": 1
  }
}

Get direct download links for a file in various qualities.

GET https://maxcloud.com/file/direct_link?key=YOUR_API_KEY&file_id=FILE_ID

{
  "status": "success",
  "links": {
    "original": "https://dl.maxcloud.com/abc123def456/original/video.mp4",
    "high": "https://dl.maxcloud.com/abc123def456/high/video.mp4",
    "medium": "https://dl.maxcloud.com/abc123def456/medium/video.mp4",
    "low": "https://dl.maxcloud.com/abc123def456/low/video.mp4"
  }
}

Delete a file from your Maxcloud storage.

DELETE https://api.maxcloud.com/v1/file/delete?key=YOUR_API_KEY&file_id=FILE_ID

{
  "status": "success",
  "message": "File deleted successfully"
}

Get a list of all your folders with optional file listing.

GET https://api.maxcloud.com/v1/folder/list?key=YOUR_API_KEY&parent_id=PARENT_ID

{
  "status": "success",
  "folders": [
    {
      "id": "123",
      "name": "Videos",
      "file_count": 5,
      "created_at": "2023-06-01T12:00:00Z"
    },
    {
      "id": "456",
      "name": "Documents",
      "file_count": 3,
      "created_at": "2023-06-02T12:00:00Z"
    }
  ],
  "files": [
    {
      "id": "abc123def456",
      "name": "video1.mp4",
      "size": 1024000
    }
  ]
}

Create a new folder in your Maxcloud storage.

POST https://api.maxcloud.com/v1/folder/create?key=YOUR_API_KEY&name=FOLDER_NAME

{
  "status": "success",
  "folder": {
    "id": "789",
    "name": "New Folder",
    "parent_id": "123",
    "created_at": "2023-06-03T12:00:00Z"
  }
}

Update a folder's name or parent folder.

POST https://api.maxcloud.com/v1/folder/edit?key=YOUR_API_KEY&folder_id=FOLDER_ID

{
  "status": "success",
  "message": "Folder updated successfully"
}