🖼️ Image Optimization API (Apify Actor)

High-performance image compression and transformation API built with Sharp and running on Apify.

Optimize, resize, convert formats, and reduce image size via a simple API call.

---

🚀 Features

• 📦 Image compression

• 🔄 Format conversion (WebP, JPEG, PNG, AVIF)

• 📏 Resize (width / height)

• 🧹 Metadata stripping (EXIF removal)

• 🖼️ Single & batch processing

• 🔗 Direct downloadable output URL

• ⚡ Fast processing with Sharp

---

📥 Input Example

{ "imageUrl": "https://example.com/image.png", "quality": 75, "format": "webp", "plan": "free" }

Input Parameters

Field	Type	Description
imageUrl	string	Direct URL of image
base64	string	Base64 image data
images	array	Multiple image URLs/base64 (paid plans)
quality	number	Compression quality (1–100)
format	string	Output format: webp, jpeg, png, avif
width	number	Resize width (optional)
height	number	Resize height (optional)
stripMetadata	boolean	Remove EXIF metadata
plan	string	free, starter, pro, business

---

📤 Output Example

Each processed image produces a dataset item:

{ "index": 1, "originalSizeKB": 1450, "optimizedSizeKB": 320, "savedPercent": 77.9, "format": "webp", "downloadUrl": "https://api.apify.com/v2/key-value-stores/XXXX/records/output-1.webp" }

If an error occurs:

{ "index": 2, "error": "Image too large (max 10MB)" }

---

📦 Free vs Paid Plans

Plan	Limitations
Free	1 image per request
Paid	Batch processing supported

---

🔧 How It Works

1. Downloads or decodes image

2. Processes with Sharp

3. Applies resize & format conversion

4. Compresses image

5. Stores optimized image

6. Returns download URL

---

🛠 Tech Stack

• Node.js

• Sharp

• Apify Actor Platform

---

⚠ Limits

• Max image size: 10MB

• Supported formats: webp, jpeg, png, avif

---

💡 Use Cases

• Web performance optimization

• CDN pre-processing

• CMS image pipeline

• Mobile app image compression

• Automation workflows

---

📄 License

ISC