Metacleaner API Documentation

Step 1: Register Your Application

Go to your dashboard's Integrations page:

There, provide:

• App name — the name of your application
• API Callback URL — the endpoint on your server where we'll redirect after authorization

After submitting, you will receive:

• A Client ID
• A Client Secret
• An Authorization Endpoint URL

Step 2: Authorize Your Application

Click the Authorization Endpoint URL. This will open a page showing:

• An Authorize button
• A Cancel button

If you click Authorize, you will be redirected to your API Callback URL with a code parameter appended:

Important: Copy this authorization code from the URL. You will need it for the next step.

Step 3: Exchange Authorization Code for Access Token

Send a POST request to:

With the following form data (application/x-www-form-urlencoded):

Example cURL

curl -X POST https://metacleaner.com/oauth/token \
     -d "grant_type=authorization_code" \
     -d "client_id=your_client_id" \
     -d "client_secret=your_client_secret" \
     -d "redirect_uri=https://your-callback.com" \
     -d "code=AUTH_CODE_HERE"

You'll receive:

{
    "token_type": "Bearer",
    "expires_in": 3600,
    "access_token": "YOUR_ACCESS_TOKEN",
    "refresh_token": "REFRESH_TOKEN"
}

Step 4: Clean Files

Use the access_token to call the cleaning endpoint:

Endpoint

Headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: multipart/form-data

Form Data

Example cURL

curl -X POST https://metacleaner.com/api/files \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "files[]=@/path/to/yourfile1.jpg" \
     -F "files[]=@/path/to/yourfile2.png"

Response

{
    "contents": [
        {
            "filename": "cleaned1749572403_yourfile1.jpg",
            "path": "https://test.metacleaner.com/storage/cleaned1749572403_yourfile1.png"
        },
        {
            "filename": "cleaned1749572404_yourfile2.png",
            "path": "https://test.metacleaner.com/storage/cleaned1749572404_yourfile2.png"
        }
    ]
}