BeeIMG API

API Base: beeimg.com/api/ (HTTP or HTTPS)

IPv6 Base: ipv6.beeimg.com/api/ (use if Cloudflare returns 403)

API Endpoints

Test URLs

Choose method and output format. The URL updates automatically.

Input Keys

Allowed File Types & Limits

Albums API

Manage albums and folders programmatically. All requests require authentication via apikey or session cookie.

List Your Albums

curl -b "uid=...;pass=..." \
     "https://beeimg.com/api/album?mode=list"

Returns all albums owned by the authenticated user.

Create an Album

curl -X POST \
     -d "action=create_album" \
     -d "title=My Album" \
     -b "uid=...;pass=..." \
     "https://beeimg.com/api/album"

Returns the new album_id (5 characters).

Get Album Details & Folders

# Get album metadata, folders, and images
curl "https://beeimg.com/api/album?id=abc12"

# Get a specific folder (9-char ID) — same endpoint
curl "https://beeimg.com/api/album?id=abcdefghi"

The response includes a folders array with each folder's id, name, and image count. Use the folder id to upload directly into it.

Create a Sub-Folder

curl -X POST \
     -d "action=create_folder" \
     -d "main_album_id=abc12" \
     -d "parent_id=abc12" \
     -d "name=Vacation 2026" \
     -b "uid=...;pass=..." \
     "https://beeimg.com/api/album"

Returns the new folder id (9 characters). Use parent_id=abc12 for top-level folders, or a folder ID for nested sub-folders.

Upload to a Sub-Folder

Use the 9-char folder ID directly as albumid — no separate folder parameter needed:

# Upload to album root (5-char master album ID)
curl -F [email protected] \
     -F apikey=aaaa \
     -F albumid=abc12 \
     https://beeimg.com/api/upload/file/json/

# Upload directly into a sub-folder (9-char folder ID as albumid)
curl -F [email protected] \
     -F apikey=aaaa \
     -F albumid=abcdefghi \
     https://beeimg.com/api/upload/file/json/

Move Images Between Folders

# Move images from one folder/album to another
curl -X POST \
     -d "action=move_image" \
     -d "from_album_id=abcdefghi" \
     -d "to_album_id=abcdef123" \
     -d "image_ids=c4661798442,t5125804229" \
     -b "uid=...;pass=..." \
     "https://beeimg.com/api/album"

Moves images from source to target. Accepts image_ids as comma-separated BIDB IDs (letter + 10 digits), or a single image_id. Images already in the target are skipped. Returns moved, skipped, and requested counts.

Move Folders

# Re-parent folders within the same album
curl -X POST \
     -d "action=move_folder" \
     -d "new_parent_id=abcdef123" \
     -d "folder_ids=aaaaaaaaa,bbbbbbbbb" \
     -b "uid=...;pass=..." \
     "https://beeimg.com/api/album"

Moves folders to a new parent within the same album. Accepts folder_ids as comma-separated 9-char IDs, or a single folder_id. Prevents moving a folder into itself or its own descendants. Returns moved, unchanged, and failed (with per-folder error details).

Move All Images in a Folder

# Move every image from one container to another
curl -X POST \
     -d "action=move_all_images" \
     -d "from_album_id=abcdefghi" \
     -d "to_album_id=abcdef123" \
     -b "uid=...;pass=..." \
     "https://beeimg.com/api/album"

Bulk-moves all images from source to target. Subfolders are not affected. Returns the number of moved images.

Get Folder Tree (for Move UI)

curl "https://beeimg.com/api/album?id=abc12&mode=tree" \
     -b "uid=...;pass=..."

Owner-only. Returns a flat list of all folders in the album (id, name, parent_id) for building a folder-tree picker in move dialogs.

• PHP
• Bash CURL
• NodeJS

		
// Initialize a cURL session
$ch = curl_init();

// Create an array containing the file to be uploaded and the API key
$postData['file'] = new CURLFile('localfile.jpg'); // Specify the local file to upload

// Add the API key (optional, required if authentication is needed)
$postData['apikey'] = "aaaa";

// Add optional parameters (e.g., album ID)
// $postData['albumid'] = "zzzz";

// Add optional parameters (e.g., privacy setting)
// $postData['privacy'] = "public"; // or "private"

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // Return the response as a string instead of outputting it
curl_setopt($ch, CURLOPT_POST, 1); // Use the HTTP POST method
curl_setopt($ch, CURLOPT_URL, 'https://beeimg.com/api/upload/file/json/'); // Set the API endpoint URL
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData); // Attach the POST data (file and API key)

// Execute the API request and store the response
$response = curl_exec($ch);

// Close the cURL session to free resources
curl_close($ch);

// Decode the JSON response into an associative array
$jsonResponse = json_decode($response, true);

// Output the response (for debugging purposes)
var_dump($jsonResponse);
		
	

		
// Initialize a cURL session
$ch = curl_init();

// Create an array containing the delete key and API key
$postData = [
    'delete_key' => 'dddd', // The key required to delete the image from the upload request
    'apikey' => 'aaaa' // API key for authentication (if required)
];

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // Return the response as a string instead of outputting it
curl_setopt($ch, CURLOPT_POST, 1); // Use the HTTP POST method
curl_setopt($ch, CURLOPT_URL, 'https://beeimg.com/delete/a123456789/'); // Set the API endpoint URL for deleting the image
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData); // Attach the POST data (delete key and API key)

// Execute the API request and get the response
$response = curl_exec($ch);

// Close the cURL session to free resources
curl_close($ch);

// Output the response (for debugging purposes)
var_dump($response); //Returns "OK" or "ERROR"
		
	

	  curl -F [email protected] https://beeimg.com/api/upload/file/text/ 
  

	  
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

// create a form and append the file
const form = new FormData();
form.append('file', fs.createReadStream('localfile.jpg'));

// add the api key
//form.append("apikey", "aaaa");
//form.append("albumid", "zzzz");
//form.append("privacy", "public"); // or "private"

// get the content-type header with the boundary
const headers = form.getHeaders();

// send the request with axios
axios.post('https://beeimg.com/api/upload/file/text/', form, {headers})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
});
      
  

Example Responses

• Text
• JSON
• XML

  
  //beeimg.com/images/a123456789.webp
  
  

  
  {
    "files": {
        "name": "p2465821538",
        "size": "6251",
        "url": "https://beeimg.com/images/p24658215384.png",
        "thumbnail_url": "https://i.beeimg.com/images/thumb/p24658215384-xs.png",
        "view_url": "https://beeimg.com/view/p2465821538/",
        "album_url": "#",
        "delete_url": "https://beeimg.com/delete/p2465821538/",
        "delete_key": "#",
        "status": "Success",
        "code": "200",
        "storage_used": 23712770,
        "storage_limit": 5368709120,
        "storage_remaining": 5344996350
    }
  }
  
  

  
  {
    "files": {
      "status": "Please come back with a URL Thank you :)",
      "code": "0"
    }
  }
  
  

  
	<?xml version="1.0"?>
	<files>
		<name>a123456789</name>
		<size>100</size>
		<url>https://beeimg.com/images/a1234567891.webp</url>
		<thumbnail_url>https://i.beeimg.com/images/thumb/a1234567891-xs.webp</thumbnail_url>
		<album_url>#</album_url>
		<view_url>https://beeimg.com/view/a123456789/</view_url>
		<delete_key>#</delete_key> <!-- "#" for apikey uploads, real key for anonymous uploads -->
		<delete_url>https://beeimg.com/delete/a123456789/</delete_url>
		<status>Success</status>
		<code>200</code>
		<storage_used>1073741824</storage_used>
		<storage_limit>53687091200</storage_limit>
		<storage_remaining>52613349376</storage_remaining>
	</files>
  
  

Error Codes