Top Files

GET

/v1/files/top

Get top files list based on number of download requests or amount of data served

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.snapbyte.io/v1/files/top?offset=0&limit=100&search=abc&range=7d&sortBy=data_served' \
--header 'x-api-key;'

Response Example

{
    "success": true,
    "data": [
        {
            "id": "f1bc65d5-3548-42ad-b67a-b7e271767921",
            "file_id": "f1bc65d5-3548-42ad-b67a-b7e271767921",
            "file_md5": "",
            "file_name": "300MB-Corrupt-Testfile.Org.zip",
            "file_size": "314572800",
            "mime_type": "application/x-zip-compressed",
            "status": 2,
            "total_requests": "21268",
            "data_served": "474116431"
        },
        {
            "id": "6965abb8-e3e3-4e6f-a556-07a2084e437c",
            "file_id": "6965abb8-e3e3-4e6f-a556-07a2084e437c",
            "file_md5": "e18053b11ecdfe8329caba3d601f5425",
            "file_name": "Screen Recording 2025-06-30 at 09.15.25.mov",
            "file_size": "50902249",
            "mime_type": "video/quicktime",
            "status": 2,
            "total_requests": "28659",
            "data_served": "470121843"
        }
    ]
}

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

offset

integer

optional

Query offset

Example:

limit

integer

optional

Number of file per page, max: 100

Example:

100

string

optional

Search file name by this string

Example:

abc

range

enum<string>

optional

Get top files in this day range

Allowed values:

7d30d60d90d

Example:

sortBy

enum<string>

optional

Allowed values:

data_servedtotal_requests

Example:

data_served

Responses

🟢200Success

application/json

Body

total

integer

required

Number of file in the result

data

object

required

string

required

File ID generated by Snapbyte

file_name

string

required

File name

file_size

integer

required

File size

file_id

string

required

File ID provided by client via API

file_md5

string

optional

mine_type

string

required

File mine type

status

enum<integer>

required

Allowed values:

1234

total_requests

string

required

Total download request to this file during {range}

data_served

string

required

Total download byte served for this file during {range}

Modified at 2025-07-09 00:15:53

Get User Stats

Get Files