API Documentation

Authentication – API Key

To use the API, you need an API key. This key verifies your identity and must be included in every request.

How do I get my API key?

Log into your account on our website or create one for free.
Go to your Profile.
Copy your API key (never share it with others!).

How do I use my API key?

Include your API key in the request header like this:

SHELL Copied!

Minify a Single File

If you have one file to minify (e.g., script.js), send a request like this:

SHELL Copied!

What Happens?

The API minifies the JavaScript file.
The minified version will have "-minified" added before the extension.
You’ll receive a download link for the minified file.

Response Example:

JSON Copied!

Download the Minified File

Copy the provided link.
Download it manually by pasting it into your browser.
Or use wget or curl to download it on your server.
SHELL Copied!
# Save it in the currect folder wget "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/script-minified.js" # Save with a custom path and filename wget -O /path/to/processed-script.js "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/script-minified.js"
SHELL Copied!
curl -o script-minified.js "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/script-minified.js"

Minify Multiple Files

If you have multiple files, send them in a single request:

SHELL Copied!

What Happens?

Each file gets minified.
You receive separate download links for each file (renamed with "-minified" at the end).
You also get a tar archive containing all minified files (not renamed).

Response Example:

JSON Copied!

{
                            "status": "success",
                            "files": [
                                {
                                    "file": "index.html",
                                    "minified": "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/index-minified.html"
                                },
                                {
                                    "file": "style.css",
                                    "minified": "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/style-minified.css"
                                },
                                {
                                    "file": "script.js",
                                    "minified": "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/script-minified.js"
                                }
                            ],
                            "tar_download": "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified/minified-files.tar"
                        }

Download All Minified Files at Once

Copy and paste the .tar link into your browser OR use:
SHELL Copied!
# Save it in the currect folder wget "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified-files.tar" # Save with a custom path and filename wget -O /path/to/minified-files.tar "https://minimo.one/downloads/a9a30db1f782ca59477f1fa2f38c3fac/minified-files.tar"
Extract the files with:
SHELL Copied!
# Extract in the current location tar -xvf minified-files.tar # Extract to a specific path tar -xvf minified-files.tar -C /path/to/

Minify an Entire Folder

To minify all files inside a folder, first compress the folder into a .tar file and send it:

SHELL Copied!

What Happens?

The API minifies all HTML, CSS, and JS files inside the folder.
The folder structure remains unchanged.
Non-code files (like images) are untouched.
You get a new .tar archive with the minified files.

Response Example:

JSON Copied!

Download and Extract It

SHELL Copied!

Compress Files (Gzip & Brotli)

This call works the same as /minify, you can add one or more files adding -F attributes like following:

SHELL Copied!

What Happens?

Files are sent to Minimo that compress the provided files in both gzip an Brotli,
The compressed version will have "-compressed" added before the extension.
You’ll receive a download link for the two generated files

Response Example:

JSON Copied!

Download Compressed Files

SHELL Copied!

Compress all Files in a Folder

To compress all .html, .css and .js files inside a folder in a single call, first compress the folder into a .tar file and send it:

SHELL Copied!

What Happens?

Minimo will get the folder and process it compressing all .html, .css and .js files.
The folder structure remains unchanged.
Non-code files (like images) are untouched.
You get a new .tar archive with both compressed .gz and .br files alongside uncompressed files in their original position.

Response Example:

JSON Copied!

Download and Extract:

SHELL Copied!

Extra Tip

Automate the process!

Want to minify and compress all files in your /public folder with a single command? You can create a Bash script to streamline the process, making it faster and more efficient—especially if you need to do this regularly.

SHELL Copied!

#!/bin/bash

API_KEY="$1"

if [[ -z "$API_KEY" ]]; then
                            exit 1
                        fi

# Go to the path where you can find your /publi folder
                        cd /path/to/webapp/ || { echo "Failed to change directory"; exit 1; }

# Minification Step
                        tar -cvf public.tar public/

MINIFY_RESPONSE=$(curl -s -X POST "https://minimo.one/api/minify" \
                            -H "Authorization: Bearer $API_KEY" \
                            -F "folder=@public.tar")

DOWNLOAD_LINK=$(echo "$MINIFY_RESPONSE" | jq -r '.download_link')

if [[ -z "$DOWNLOAD_LINK" || "$DOWNLOAD_LINK" == "null" ]]; then
                            echo "Minification failed. Response: $MINIFY_RESPONSE"
                            exit 1
                        fi

wget -O public-minified.tar "$DOWNLOAD_LINK"

rm -rf public/
                        tar -xvf public-minified.tar
                        rm public.tar public-minified.tar

# Compression Step
                        tar -cvf public.tar public/

COMPRESS_RESPONSE=$(curl -s -X POST "https://minimo.one/api/compress" \
                            -H "Authorization: Bearer $API_KEY" \
                            -F "folder=@public.tar")

DOWNLOAD_LINK=$(echo "$COMPRESS_RESPONSE" | jq -r '.download_link')

if [[ -z "$DOWNLOAD_LINK" || "$DOWNLOAD_LINK" == "null" ]]; then
                            echo "Compression failed. Response: $COMPRESS_RESPONSE"
                            exit 1
                        fi

wget -O public-compressed.tar "$DOWNLOAD_LINK"

rm -rf public/
                        tar -xvf public-compressed.tar
                        rm public.tar public-compressed.tar
                        echo "Minification and compression completed successfully."

How to Use:

Save the script as a .sh file.
Run it using:
SHELL Copied!
./yourScript.sh YOUR_API_KEY

📌 Note: Make sure jq is installed on your system before running the script!

SHELL Copied!

API Documentation

Authentication – API Key

How do I get my API key?

How do I use my API key?

Minify Files `/minify`

Minify a Single File

What Happens?

Response Example:

Download the Minified File

Minify Multiple Files

What Happens?

Response Example:

Download All Minified Files at Once

Minify an Entire Folder

What Happens?

Response Example:

Download and Extract It

Compress Files `/compress`

Compress Files (Gzip & Brotli)

What Happens?

Response Example:

Download Compressed Files

Compress all Files in a Folder

What Happens?

Response Example:

Download and Extract:

Extra Tip

Automate the process!

How to Use:

API Documentation

Authentication – API Key

How do I get my API key?

How do I use my API key?

Minify Files /minify

Minify a Single File

What Happens?

Response Example:

Download the Minified File

Minify Multiple Files

What Happens?

Response Example:

Download All Minified Files at Once

Minify an Entire Folder

What Happens?

Response Example:

Download and Extract It

Compress Files /compress

Compress Files (Gzip & Brotli)

What Happens?

Response Example:

Download Compressed Files

Compress all Files in a Folder

What Happens?

Response Example:

Download and Extract:

Extra Tip

Automate the process!

How to Use:

Minify Files `/minify`

Compress Files `/compress`