Image Compression API Documentation

Complete guide to using ImageCompressAPI for image compression, resizing, and format conversion. Our image compression API and image resize API provide developers with powerful tools to optimize images programmatically.

Get started in minutes with our REST API. Supports bulk image compression, AVIF and WebP conversion, custom image sizes, and more.

Getting Started

Base URL

https://api.imagecompressapi.com/v1

Authentication

All API requests require authentication using your API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key by signing up for a free account. No credit card required.

Compress Image

Compress a single image or multiple images in bulk. Supports JPEG, PNG, WebP, and AVIF formats.

Endpoint

POST /compress

Request Parameters

Parameter	Type	Required	Description
image	File	Yes	Image file to compress (JPEG, PNG, WebP, AVIF)
quality	Integer	No	Compression quality (1-100, default: 80)
format	String	No	Output format: jpg, png, webp, avif (default: original)
width	Integer	No	Resize width in pixels
height	Integer	No	Resize height in pixels

Example Request

curl -X POST https://api.imagecompressapi.com/v1/compress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg" \
  -F "quality=80" \
  -F "format=webp" \
  -F "width=1200"

Response

{
  "success": true,
  "data": {
    "url": "https://cdn.imagecompressapi.com/compressed/abc123.webp",
    "original_size": 2456789,
    "compressed_size": 456789,
    "savings": 81.4,
    "format": "webp",
    "width": 1200,
    "height": 800
  }
}

Bulk Compression

Process multiple images in a single API request. Upload up to 100 images per request.

Endpoint

POST /compress/bulk

Example Request

curl -X POST https://api.imagecompressapi.com/v1/compress/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "images[]=@image1.jpg" \
  -F "images[]=@image2.jpg" \
  -F "images[]=@image3.jpg" \
  -F "quality=80" \
  -F "format=webp"

Resize Image

Resize images to specific dimensions while maintaining aspect ratio or custom cropping.

Endpoint

POST /resize

Additional Parameters

Parameter	Description
maintain_aspect	Boolean. Maintain aspect ratio when resizing (default: true)
crop	Boolean. Crop image to exact dimensions (default: false)

Error Handling

The API uses standard HTTP status codes. Errors are returned in JSON format:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or missing API key"
  }
}

Common Error Codes

400

Bad Request

Invalid parameters or malformed request

401

Unauthorized

Invalid or missing API key

429

Rate Limit Exceeded

Too many requests. Check your plan limits

500

Server Error

Internal server error. Please try again later

Rate Limits

Rate limits vary by plan. Rate limit information is included in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

SDKs and Libraries

Official SDKs are available for popular programming languages to simplify integration with our image compression API:

JavaScript/Node.js

npm install @imagecompressapi/sdk

Python

pip install imagecompressapi

PHP

composer require imagecompressapi/sdk

Ruby

gem install imagecompressapi

Getting Started with Image Compression API

Our image compression API provides a simple, powerful way to optimize images programmatically. Whether you're building a content management system, e-commerce platform, or mobile application, our API handles image compression seamlessly. The bulk image compression API allows you to process hundreds of images in a single request, making it ideal for batch operations and automated workflows.

The image resize API gives you precise control over output sizes. You can specify exact dimensions, maintain aspect ratios, or crop images to specific requirements. When combined with compression, our image compression and resize API becomes a complete solution for all your image optimization needs.

Modern web performance demands modern formats. Our AVIF image compression API delivers superior compression ratios compared to traditional formats, often reducing file sizes by 50% or more while maintaining visual quality. Similarly, our WebP image compression API provides excellent browser compatibility and significant file size reductions.

All API endpoints use standard REST conventions and return JSON responses. Authentication is handled via API keys, which you can obtain by signing up for a free account. The API supports both synchronous and asynchronous processing, with webhook notifications available for long-running operations.