API Documentation

Use our robust API to upload and manage your images

Quick Start

Upload an Image

curl -F "[email protected]" https://img.mrbean.dev/api/upload.php

Create Text Paste

curl -F "api_paste_code=Hello World" https://img.mrbean.dev/api/pastebin.php

API Reference

POST /api/upload.php

Upload files directly to the server.

Parameters

Name	Description	Required
`file`	The file to upload	Required

Example Request

curl -F "[email protected]" https://img.mrbean.dev/api/upload.php

Example Response

{
  "status": "ok",
  "hash": "y1b6hr.jpg",
  "url": "https://img.mrbean.dev/y1b6hr.jpg",
  "delete_code": "z0e1mdo8szxnauspxp2f080e4wd4ycf2",
  "delete_url": "https://img.mrbean.dev/delete_z0e1mdo8szxnauspxp2f080e4wd4ycf2/y1b6hr.jpg"
}

Error Response

{
  "status": "err",
  "reason": "Unsupported filetype"
}

GET /api/geturl.php

Upload content by providing a link to the content. If the URL is a webpage, it will save the HTML content as a text file.

Parameters

Name	Description	Required
`url`	URL of the content to upload	Required

Example Request

curl -s "https://img.mrbean.dev/api/geturl.php?url=https://xkcd.com"

Example Response (HTML Content)

{
  "status": "ok",
  "hash": "2mr2va.txt",
  "url": "https://img.mrbean.dev/2mr2va.txt",
  "filetype": "text",
  "delete_code": "aqxqlv3kqokxd15xpkqp8zjljpqerveu",
  "delete_url": "https://img.mrbean.dev/delete_aqxqlv3kqokxd15xpkqp8zjljpqerveu/2mr2va.txt"
}

Example Request (Media File)

curl "https://img.mrbean.dev/api/geturl.php?url=https://i.imgur.com/qQstLQt.mp4"

Example Response

{
  "status": "ok",
  "hash": "u0ni1m.mp4",
  "url": "https://img.mrbean.dev/u0ni1m.mp4",
  "filetype": "mp4",
  "delete_code": "aqxqlv3kqokxd15xpkqp8zjljpqerveu",
  "delete_url": "https://img.mrbean.dev/delete_aqxqlv3kqokxd15xpkqp8zjljpqerveu/u0ni1m.mp4"
}

Error Response

{
  "status": "err",
  "reason": "Unsupported filetype"
}

POST/GET /api/pastebin.php

This API can be used to directly post text. Server responds with the URL to the bin or with an error message.

Parameters

Name	Description	Required
`api_paste_code`	The text content to paste	Required

Example Request

curl -F "api_paste_code=Hello World" https://img.mrbean.dev/api/pastebin.php

Example Response

https://img.mrbean.dev/vekjy4e5rr.txt

GET /api/info.php

This API will get information about any given hash.

Parameters

Name	Description	Required
`hash`	Hash of the file to get information about	Required

Example Request

curl "https://img.mrbean.dev/api/info.php?hash=9k3rbw.mp4"

Example Response

{
  "status": "ok",
  "hash": "9k3rbw.mp4",
  "size_bytes": 2513225,
  "size_interpreted": "2.4 MB",
  "type": "video/mp4",
  "type_interpreted": "mp4"
}

POST /api/base64.php

Upload base64 encoded images to the server.

Parameters

Name	Description	Required
`base64`	The base64 encoded image data	Required

Example Request

(echo -n "base64="; echo -n "data:image/jpeg;base64,$(base64 -w 0 test.jpg)") | \
curl --data @- https://img.mrbean.dev/api/base64.php

Example Response

{
  "status": "ok",
  "hash": "lpl119.jpg",
  "url": "https://img.mrbean.dev/lpl119.jpg",
  "filetype": "jpeg",
  "delete_code": "z0e1mdo8szxnauspxp2f080e4wd4ycf2",
  "delete_url": "https://img.mrbean.dev/delete_z0e1mdo8szxnauspxp2f080e4wd4ycf2/lpl119.jpg"
}

Code Samples

Upload an Image with PHP

function uploadImage($imagePath) {
    if (!file_exists($imagePath)) return false;
    
    $ch = curl_init('https://img.mrbean.dev/api/upload.php');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, [
        'file' => curl_file_create($imagePath)
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

$result = uploadImage('test.jpg');
echo $result['url']; // Outputs: https://img.mrbean.dev/y1b6hr.jpg

Create a Text Paste with PHP

function createTextPaste($text) {
    $ch = curl_init('https://img.mrbean.dev/api/pastebin.php');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, [
        'api_paste_code' => $text
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return $response;
}

$pasteUrl = createTextPaste('Hello World from PHP!');
echo $pasteUrl; // Outputs: https://img.mrbean.dev/vekjy4e5rr.txt

Upload from URL with PHP

function uploadFromUrl($url) {
    $encodedUrl = urlencode($url);
    $requestUrl = "https://img.mrbean.dev/api/geturl.php?url={$encodedUrl}";
    
    $ch = curl_init($requestUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

$result = uploadFromUrl('https://i.imgur.com/qQstLQt.mp4');
echo $result['url']; // Outputs: https://img.mrbean.dev/u0ni1m.mp4

Upload an Image with JavaScript

// Using Fetch API to upload a file
async function uploadImage(fileInput) {
  const formData = new FormData();
  formData.append('file', fileInput.files[0]);
  
  try {
    const response = await fetch('https://img.mrbean.dev/api/upload.php', {
      method: 'POST',
      body: formData
    });
    
    const data = await response.json();
    if (data.status === 'ok') {
      console.log('Upload successful:', data.url);
      return data;
    } else {
      console.error('Upload failed:', data.reason);
      return null;
    }
  } catch (error) {
    console.error('Error uploading file:', error);
    return null;
  }
}

// Example usage with a file input
document.getElementById('fileInput').addEventListener('change', async (e) => {
  const result = await uploadImage(e.target);
  if (result) {
    document.getElementById('imagePreview').src = result.url;
  }
});

Create a Text Paste with JavaScript

async function createTextPaste(text) {
  const formData = new FormData();
  formData.append('api_paste_code', text);
  
  try {
    const response = await fetch('https://img.mrbean.dev/api/pastebin.php', {
      method: 'POST',
      body: formData
    });
    
    const data = await response.text();
    console.log('Paste URL:', data);
    return data;
  } catch (error) {
    console.error('Error creating paste:', error);
    return null;
  }
}

// Example usage
createTextPaste('Hello World from JavaScript!')
  .then(url => {
    document.getElementById('pasteLink').href = url;
    document.getElementById('pasteLink').textContent = url;
  });

Upload from URL with JavaScript

async function uploadFromUrl(url) {
  try {
    const encodedUrl = encodeURIComponent(url);
    const response = await fetch('https://img.mrbean.dev/api/geturl.php?url=' + encodedUrl);
    
    const data = await response.json();
    if (data.status === 'ok') {
      console.log('URL upload successful:', data.url);
      return data;
    } else {
      console.error('URL upload failed:', data.reason);
      return null;
    }
  } catch (error) {
    console.error('Error uploading from URL:', error);
    return null;
  }
}

// Example usage
uploadFromUrl('https://i.imgur.com/qQstLQt.mp4')
  .then(result => {
    if (result) {
      const mediaElement = document.getElementById('mediaElement');
      if (result.filetype === 'mp4' || result.filetype === 'webm') {
        // For video files
        mediaElement.innerHTML = '';
      } else {
        // For image files or other types
        mediaElement.innerHTML = '';
      }
    }
  });

Upload an Image with Python

import requests

def upload_image(file_path):
    with open(file_path, 'rb') as f:
        response = requests.post(
            'https://img.mrbean.dev/api/upload.php',
            files={'file': f}
        )
    
    if response.status_code == 200:
        data = response.json()
        if data.get('status') == 'ok':
            print("Upload successful: " + data['url'])
            return data
        else:
            print("Upload failed: " + str(data.get('reason')))
            return None
    else:
        print("Request failed with status code: " + str(response.status_code))
        return None

# Example usage
result = upload_image('test.jpg')
if result:
    print("Image URL: " + result['url'])
    print("Delete URL: " + result['delete_url'])

Create a Text Paste with Python

import requests

def create_text_paste(text):
    response = requests.post(
        'https://img.mrbean.dev/api/pastebin.php',
        data={'api_paste_code': text}
    )
    
    if response.status_code == 200:
        return response.text
    else:
        print(f"Request failed with status code: {response.status_code}")
        return None

# Example usage
paste_url = create_text_paste('Hello World from Python!')
print("Paste URL: " + paste_url)

Upload from URL with Python

import requests

def upload_from_url(url):
    params = {'url': url}
    response = requests.get(
        'https://img.mrbean.dev/api/geturl.php',
        params=params
    )
    
    if response.status_code == 200:
        try:
            data = response.json()
            if data.get('status') == 'ok':
                print("Upload successful: " + data['url'])
                return data
            else:
                print("Upload failed: " + str(data.get('reason')))
                return None
        except ValueError:
            print("Invalid JSON response")
            return None
    else:
        print("Request failed with status code: " + str(response.status_code))
        return None

# Example usage
result = upload_from_url('https://i.imgur.com/qQstLQt.mp4')
if result:
    print("Media URL: " + result['url'])

Upload an Image with Bash

#!/bin/bash

# Function to upload an image
upload_image() {
  local file_path=$1
  if [ ! -f "$file_path" ]; then
    echo "File not found: $file_path"
    return 1
  fi
  
  response=$(curl -s -F "file=@$file_path" https://img.mrbean.dev/api/upload.php)
  url=$(echo $response | grep -o '"url":"[^"]*"' | cut -d'"' -f4)
  
  if [ -n "$url" ]; then
    echo "Upload successful: $url"
    echo "$url"
  else
    echo "Upload failed: $response"
    return 1
  fi
}

# Example usage
image_url=$(upload_image "test.jpg")
echo "Uploaded image URL: $image_url"

Bash Aliases for Easier Usage

# Add to your .bashrc or .zshrc
# For file uploads
pict () {
    curl -s -F "file=@${1:--}" https://img.mrbean.dev/api/upload.php | jq -r '.url';
}

# For URL uploads
pictget () {
    curl -s "https://img.mrbean.dev/api/geturl.php?url=$1" | jq -r '.url';
}

# Usage examples:
# $ cat path/to/image.jpg | pict
# $ pictget https://i.imgur.com/qQstLQt.mp4

Create a Text Paste with Bash

#!/bin/bash

# Function to create a text paste
create_paste() {
  local text="$1"
  
  response=$(curl -s -F "api_paste_code=$text" https://img.mrbean.dev/api/pastebin.php)
  
  echo "$response"
}

# Example usage
paste_url=$(create_paste "Hello World from Bash!")
echo "Paste URL: $paste_url"

# Create a paste from a file
paste_from_file() {
  local file_path="$1"
  if [ ! -f "$file_path" ]; then
    echo "File not found: $file_path"
    return 1
  fi
  
  text=$(cat "$file_path")
  create_paste "$text"
}

# Example usage
paste_url=$(paste_from_file "readme.txt")
echo "File paste URL: $paste_url"