Log In Sign Up

API Documentation

Account
GET

Account Info

Endpoint
https://uploady.io/api/account/info?key=key
Parameters
key*StringYour API key. Example: 1saep52buejc4ngwo
Response
{
    "msg": "OK",
    "server_time": "2024-01-15 12:00:00",
    "status": 200,
    "result": {
        "email": "your@email.com",
        "balance": "25.00",
        "premium_expire": "2025-06-01 00:00:00",
        "storage_used": 1073741824,
        "storage_left": "inf"
    }
}
GET

Account Stats

Endpoint
https://uploady.io/api/account/stats?key=key&last=last
Parameters
key*StringYour API key
lastNumberDays to show. Default: 7
date1StringStart date YYYY-MM-DD
date2StringEnd date YYYY-MM-DD
Response
{
    "msg": "OK",
    "status": 200,
    "result": [
        {
            "day": "2024-01-15",
            "downloads": "142",
            "sales": "3",
            "profit_dl": "0.84500",
            "profit_sales": "2.00000",
            "profit_total": "2.84500"
        }
    ]
}
Upload
GET

Upload Server

Endpoint
https://uploady.io/api/upload/server?key=key
Parameters
key*StringYour API key
Important
  • Request a new URL and sess_id for every upload — never reuse or cache the sess_id.
  • Expired sess_id returns: session expired, please request a new upload URL
  • Without a valid sess_id the file won't appear in your account.
Upload form
<form enctype="multipart/form-data" action="UPLOAD_SERVER_URL" method="post">
    <input name="sess_id" value="{sess_id}">
    <input name="file" type="file">
</form>
Response
{
    "msg": "OK",
    "status": 200,
    "result": "https://s1.uploady.download/upload/01",
    "sess_id": "qbesbigb7r4pwo5wcz6t..."
}
GET

Upload URL (Remote)

Queue a remote file URL for upload. The file is fetched and added to your account asynchronously.

Endpoint
https://uploady.io/api/upload/url?key=key&url=url&folder=folder
Parameters
key*StringYour API key
url*StringRemote file URL. Example: https://example.com/file.zip
folderNumberDestination folder ID (optional)
Response
{
    "msg": "OK",
    "status": 200,
    "result": { "filecode": "abc123xyz456" }
}
Files
GET

Get File Info

Endpoint
https://uploady.io/api/file/info?key=key&file_code=file_code
Parameters
key*StringYour API key
file_code*StringCode or comma-separated list (max 50). Example: gi4o0tlro01u,abc123
Response
{
    "msg": "OK",
    "status": 200,
    "result": [
        {
            "status": 200,
            "filecode": "gi4o0tlro01u",
            "name": "video.mp4",
            "downloads": "42",
            "size": "104857600",
            "uploaded": "2024-01-10 08:15:30"
        },
        { "status": 404, "filecode": "abc123" }
    ]
}
GET

Get Files List

Endpoint
https://uploady.io/api/file/list?key=key&page=page&per_page=per_page&fld_id=fld_id&public=public&created=created&name=name
Parameters
key*StringYour API key
pageNumberPage number
per_pageNumberResults per page (max 1000, default 100)
fld_idNumberFilter by folder ID
publicNumber1 public only · 0 private only
createdStringTimestamp or minutes ago. Example: 2024-01-01 00:00:00 or 60
nameStringFilter by filename (partial). Example: Iron Man
Response
{
    "msg": "OK",
    "status": 200,
    "result": {
        "results": 2,
        "results_total": 847,
        "files": [
            {
                "file_code": "gi4o0tlro01u",
                "name": "video.mp4",
                "size": "104857600",
                "public": 1,
                "downloads": "42",
                "uploaded": "2024-01-10 05:07:17",
                "link": "https://uploady.io/gi4o0tlro01u.html"
            }
        ]
    }
}
GET

Rename File

Endpoint
https://uploady.io/api/file/rename?key=key&file_code=file_code&name=name
Parameters
key*StringYour API key
file_code*String12-character file code
name*StringNew filename (min 2 chars). Example: cool_video.mp4
Response
{ "msg": "OK", "status": 200, "result": "true" }
GET

Set File Folder

Endpoint
https://uploady.io/api/file/set_folder?key=key&file_code=file_code&fld_id=fld_id
Parameters
key*StringYour API key
file_code*StringCode or comma-separated list
fld_id*NumberTarget folder ID. Example: 15
Response
{ "msg": "OK", "status": 200 }
GET

Clone File

Creates a copy with a new file code sharing the same physical data. Requires Clone API to be enabled on your account.

Endpoint
https://uploady.io/api/file/clone?key=key&file_code=file_code&fld_id=fld_id
Parameters
key*StringYour API key
file_code*StringSource file code
fld_idNumberDestination folder ID (optional)
Response
{
    "msg": "OK",
    "status": 200,
    "result": {
        "filecode": "newcode123456",
        "url": "https://uploady.io/newcode123456"
    }
}
GET

Get Deleted Files

Endpoint
https://uploady.io/api/files/deleted?key=key&last=last
Parameters
key*StringYour API key
lastNumberMinutes to look back. Default: 1440 (24 hours)
Response
{
    "msg": "OK",
    "status": 200,
    "result": [
        {
            "file_code": "gtl2mhgw4is7",
            "name": "archive.zip",
            "deleted": "2024-01-15 14:22:01",
            "deleted_ago_sec": "3600"
        }
    ]
}
Folders
GET

Get Folder List

Endpoint
https://uploady.io/api/folder/list?key=key&fld_id=fld_id
Parameters
key*StringYour API key
fld_idNumberFolder ID (omit for root)
Response
{
    "msg": "OK",
    "status": 200,
    "result": {
        "folders": [ { "fld_id": "24", "name": "Movies", "code": "abc" } ],
        "files": [
            {
                "file_code": "4w0sy8e63f0c",
                "name": "100mb.bin",
                "fld_id": "0",
                "uploaded": "2024-01-10 04:06:39",
                "link": "https://uploady.io/4w0sy8e63f0c.html"
            }
        ]
    }
}
GET

Create New Folder

Endpoint
https://uploady.io/api/folder/create?key=key&parent_id=parent_id&name=name
Parameters
key*StringYour API key
parent_idNumberParent folder ID (omit for root)
name*StringFolder name (min 2 chars). Example: New Folder
Response
{ "msg": "OK", "status": 200, "result": { "fld_id": "26" } }
GET

Rename Folder

Endpoint
https://uploady.io/api/folder/rename?key=key&fld_id=fld_id&name=name
Parameters
key*StringYour API key
fld_id*NumberFolder ID
name*StringNew name (min 2 chars)
Response
{ "msg": "OK", "status": 200, "result": "true" }
Error codes
200 Success — request completed 400 Bad request — invalid or missing parameters 403 Forbidden — wrong key, disabled feature, or not your file 404 Not found — file or folder does not exist 451 Legal — file removed due to DMCA takedown