Image Compressor & Resizer API: Target KB, WebP
Pricing
$2.00 / 1,000 image processeds
Image Compressor & Resizer API: Target KB, WebP
Image compressor and resizer: shrink images from URLs or base64, resize by width or height, compress to a target size in KB, and convert to WebP or AVIF. EXIF stripped. Before/after bytes per file. $0.002 per image.
Pricing
$2.00 / 1,000 image processeds
Rating
0.0
(0)
Developer
Ferrolark
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 days ago
Last modified
Categories
Features
Share
Image Compress & Resize: Target KB, Width, WebP & AVIF API
Make images smaller with one API call:
- Resize by width and/or height. There are four fit modes, and images are never upscaled unless you allow it.
- Compress to a target size, for example "under 250 KB". The Actor searches for the highest quality that fits.
- Convert while compressing to WebP or AVIF, or keep the original format.
- Strip EXIF (GPS location, camera data) while keeping the color profile.
- Before/after manifest per file (bytes, % saved, dimensions, quality used, SHA-256), plus a ZIP.
It accepts URLs or base64 (n8n and Make binaries) and works with PNG, JPEG, WebP, AVIF, HEIC, GIF, TIFF, BMP and SVG.
Real example
A 14.7 MB, 10109×4542 panorama from Wikimedia, resized to 1600 px wide with a 250 KB cap:
{"imageUrls": ["https://upload.wikimedia.org/wikipedia/commons/3/3f/Fronalpstock_big.jpg"],"width": 1600,"targetKB": 250}
- Result:
Fronalpstock_big.jpg, 1600×719, 208,491 bytes (98.6% smaller), JPEG quality 82. - Run time: 6.1 s on Apify at 1,024 MB, including downloading 14.7 MB.
- Platform usage: $0.0006.
- Your cost: $0.002.
{"fileName": "Fronalpstock_big.jpg","mimeType": "image/jpeg","bytes": 208491,"sha256": "e7a64c72025855e99d51e3d2b9925a280b0d174c54db20e5081c7868db8f202b","downloadUrl": "https://api.apify.com/v2/key-value-stores/<store-id>/records/Fronalpstock_big.jpg","inputFormat": "jpeg","inputBytes": 14679474,"inputWidth": 10109,"inputHeight": 4542,"format": "jpeg","width": 1600,"height": 719,"quality": 82,"savedPercent": 98.6,"keptOriginal": false,"targetReached": true}
In a local test of the same engine, the 224 KB Wikimedia transparency-demo PNG converted to WebP at 800 px with a 60 KB target came out at 61,356 bytes (quality 38, 72.7% smaller). The alpha channel was kept.
Price and limits
- $0.002 per processed image. The ZIP is free. Failed files are not charged.
- Limits:
- 50 images and 100 MB per run;
- 50 megapixels per input image;
- output up to 10,000 px per side.
- The target-size search covers quality 30 up to your
qualitysetting (default 82). If even quality 30 is too big, you get the smallest result andtargetReached: falsewith a warning. Reduce the dimensions, or switch to WebP or AVIF.
Input
| Field | Default | What it does |
|---|---|---|
imageUrls / files | none | URLs, or [{"base64": "...", "name": "..."}]. |
width, height | none | Target box. With only one of them, the aspect ratio is kept. |
fit | inside | inside keeps the ratio within the box; cover fills and crops the center; contain pads with the background; fill stretches. |
allowUpscale | false | Allow enlarging small images. |
targetKB | none | Maximum output size in KB (lossy formats). |
quality | 82 | Quality, or the upper bound of the target search. |
format | keep | Keep the format, or convert to WebP, AVIF, JPEG, PNG, HEIC, TIFF, GIF or BMP. |
onlyIfSmaller | true | If nothing but re-compression was asked and the result isn't smaller, return the original bytes. |
backgroundColor, keepColorProfile, createZip, createShareableUrl | Same as in Image Convert. |
Call it from code, n8n or an AI agent
API (synchronous):
curl -X POST "https://api.apify.com/v2/acts/ferrolark~image-compress-resize/run-sync-get-dataset-items?maxTotalChargeUsd=0.1" \-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \-d '{"imageUrls": ["https://example.com/hero.png"], "width": 1200, "format": "webp", "targetKB": 150}'
n8n: paste this workflow on the canvas (Ctrl+V). Then add a Header Auth credential with the name Authorization and the value Bearer <your Apify token>, and use it in both HTTP nodes. The second node downloads the optimized image as a binary. To process binaries that are already in n8n, send them in files as base64.
{"name": "Ferrolark image-compress-resize","nodes": [{"parameters": {},"name": "When clicking Test workflow","type": "n8n-nodes-base.manualTrigger","typeVersion": 1,"position": [0,0]},{"parameters": {"method": "POST","url": "https://api.apify.com/v2/acts/ferrolark~image-compress-resize/run-sync-get-dataset-items?maxTotalChargeUsd=0.05","authentication": "genericCredentialType","genericAuthType": "httpHeaderAuth","sendBody": true,"specifyBody": "json","jsonBody": "{\"imageUrls\": [\"https://upload.wikimedia.org/wikipedia/commons/3/3f/Fronalpstock_big.jpg\"], \"width\": 1600, \"targetKB\": 250}","options": {"timeout": 300000}},"name": "Run Actor","type": "n8n-nodes-base.httpRequest","typeVersion": 4.2,"position": [220,0]},{"parameters": {"url": "={{ $json.downloadUrl }}","authentication": "genericCredentialType","genericAuthType": "httpHeaderAuth","options": {"response": {"response": {"responseFormat": "file"}}}},"name": "Download file","type": "n8n-nodes-base.httpRequest","typeVersion": 4.2,"position": [440,0]}],"connections": {"When clicking Test workflow": {"main": [[{"node": "Run Actor","type": "main","index": 0}]]},"Run Actor": {"main": [[{"node": "Download file","type": "main","index": 0}]]}}}
Make / Zapier: use the Apify app's "Run Actor" action with ferrolark/image-compress-resize.
AI agents (MCP): add ferrolark/image-compress-resize to the Apify MCP server (https://mcp.apify.com?actors=ferrolark/image-compress-resize).
Use cases
- Meet upload limits: marketplaces, CMSs, email tools and forms that cap images at 200 KB or 1 MB.
- Shrink user uploads before storing them, without running ImageMagick yourself.
- Make thumbnails and social sizes, for example 1200×630 with
fit: cover. - Batch-optimize a site's images to WebP or AVIF for Core Web Vitals.
Troubleshooting
targetReached: false: the size is too small for those dimensions. Lowerwidth, or useformat: "webp"or"avif".- PNG stays big: PNG is lossless, so
targetKBcannot lower its quality. Resize it, or convert to WebP. keptOriginal: true: the original was already better compressed, so you got it back unchanged.
Limitations
- No AI upscaling, cropping by face or object, or background removal.
- Animated images are processed from their first frame.
Changelog
- 1.0 (November 2026): first release. Resize with four fit modes, target-KB search, format conversion, EXIF stripping, ZIP and before/after manifest.
More Ferrolark tools
- Brand Name Availability Checker: domains, GitHub, npm, PyPI and more in one report.
- Domain Intelligence Report: WHOIS, DNS, email security, SSL and hosting for any domain.
- Launch Asset Pack: favicons, PWA icons, OG image and head tags from one logo.
- Live Deploy QA: meta tags, canonical, robots, OG image and favicon of your deployed routes, with diffs between deploys.
- Sitemap Delta: new, removed and broken URLs in any sitemap since the last run.
- RSS Delta: only new RSS, Atom and JSON Feed items, de-duplicated.
- PDF Merge API: merge PDFs from URLs or base64 with page ranges and a SHA-256 manifest.
- PDF Split API: split a PDF by page ranges or every N pages, or extract pages, with a ZIP and manifest.
- Image Convert: PNG, JPG, WebP, AVIF and HEIC conversion (SVG input too) from URLs or base64.
- PDF to Image: PDF pages to PNG, JPG or WebP at the DPI you choose.
- Image to PDF: JPG, PNG, HEIC and WebP images to one PDF, JPEGs embedded without recompression.
- PDF Compress: smaller PDFs, lossless or with image downsampling; charged only when smaller.
- HTML to PDF & URL to PDF: web pages or raw HTML to PDF with headless Chrome.
- Markdown to PDF: Markdown with tables, code and footnotes to a clean PDF.
- DOCX to PDF: Word, Excel, PowerPoint and ODT to PDF with LibreOffice.
- Data Convert: CSV, JSON, NDJSON and Excel XLSX in any direction.
Built by Ferrolark.