DEVELOPER INTEGRATION

REST API Documentation

Integrate high-speed image uploads into ShareX, desktop apps, mobile applications, or command-line scripts.

API Endpoints

🔑 Authentication

Authenticate requests by including your secret API key in the Authorization header as a Bearer token or by providing the key parameter in your request.

Authorization: Bearer YOUR_API_KEY
POST
/api/v1/upload.php

Upload an image file using standard multipart/form-data encoding.

Request Parameters
Field Type Required Description
image File Yes Image binary file (JPG, PNG, GIF, WebP, AVIF, SVG)
resize String No Optional: none, 100x100, 320x240, 640x480, 800x600, 1024x768, 1280w, 1920w
expiration String No Optional: never, 1d, 7d, 31d
visibility String No public, unlisted, or private
Example cURL Request
curl -X POST "https://imgup.softkeybazar.com/api/v1/upload.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@/path/to/photo.jpg" \
  -F "resize=none"
Sample JSON Response (200 OK)
{
  "status": "success",
  "data": {
    "id": "img_k9x2m8q1",
    "file_name": "img_k9x2m8q1.jpg",
    "original_name": "photo.jpg",
    "width": 1920,
    "height": 1080,
    "size": 452100,
    "url": {
      "direct": "https://imgup.softkeybazar.com/uploads/original/2026/10/img_k9x2m8q1.jpg",
      "viewer": "https://imgup.softkeybazar.com/view.php?id=img_k9x2m8q1",
      "thumbnail": "https://imgup.softkeybazar.com/uploads/thumbs/2026/10/img_k9x2m8q1_thumb.jpg",
      "delete": "https://imgup.softkeybazar.com/delete.php?id=img_k9x2m8q1&token=..."
    }
  }
}
GET
/api/v1/image.php?id={image_id}

Retrieve image information, view counts, dimensions, and URLs.

curl "https://imgup.softkeybazar.com/api/v1/image.php?id=img_k9x2m8q1"
DELETE
/api/v1/delete.php?id={image_id}

Permanently delete an image owned by the authenticated API key or with delete token.

curl -X DELETE "https://imgup.softkeybazar.com/api/v1/delete.php?id=img_k9x2m8q1" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET
/api/v1/usage.php

Check remaining storage quota, upload metrics, and current subscription plan tier.

curl "https://imgup.softkeybazar.com/api/v1/usage.php" \
  -H "Authorization: Bearer YOUR_API_KEY"
Chat on WhatsApp