For developers
The imgsize.cc API
A small, public, free, no-auth catalog of every platform preset on imgsize.cc — the exact pixel dimensions, aspect ratio, max file size, supported formats, and background requirement for Amazon Main Image, Instagram Reel, YouTube Thumbnail, LinkedIn Cover, and 80+ others.
1. Full preset catalog
Returns every preset in one call. Use this when you need to discover what imgsize.cc supports.
GET /api/presets.json public · cache 1h curl https://imgsize.cc/api/presets.json | jq '.presets | length'
> 802. Single preset detail
Returns the full preset record including the long-form SEO description and platform-aware background rules.
GET /api/preset/{slug}.json public · cache 1h curl https://imgsize.cc/api/preset/amazon-main.json | jq '.dimensions'
> "2000×2000"3. Response shape
Each preset in /api/presets.json
includes these fields:
| Field | Type | Example |
|---|---|---|
| slug | string | "amazon-main" |
| title | string | "Amazon Main Image" |
| category | string | "marketplace" |
| dimensions | string | "2000×2000" |
| aspect | string | "1:1" |
| maxSize | string | "10 MB" |
| formats | string | "JPEG, PNG, TIFF, GIF" |
| background | string | "Pure white (RGB 255,255,255)" |
Common recipes
Find all social presets for a category
curl -s https://imgsize.cc/api/presets.json | \\
jq '.presets[] | select(.category=="instagram")'Validate a configuration
curl -sf https://imgsize.cc/api/preset/amazon-main.json \\
| jq '.dimensions'Build a "what size?" CLI
function size() {
curl -s "https://imgsize.cc/api/preset/$1.json" | \\
jq -r '"{{.title}} — {{.dimensions}} ({{.aspect}})"'
}
$ size amazon-main
> Amazon Main Image — 2000×2000 (1:1)Spreadsheet-friendly CSV
curl -s https://imgsize.cc/api/presets.json | \\
jq -r '.presets[]
| [.slug, .category, .dimensions, .aspect] | @csv'Integration patterns
- No-auth, no-rate-limit. This is a static catalog. Cache it on your side for 24 hours; refresh when you need to.
- CORS open. Every endpoint serves
Access-Control-Allow-Origin: *, so you can fetch from browser scripts. - No image-processing API. imgsize.cc does image work in the browser via the Canvas API; we do not expose a hosted resize endpoint. The catalog tells your code what to resize to; the actual resize happens client-side or via your own backend.
- Stable slug names. Slugs are versioned — once a slug is published, we won't rename it. We'll add new presets with new slugs.
- Use the SEO page for prose. If you need a human-readable description, link to
/presets/{slug}rather than embedding our lede.
No-code integrations
Coming soon: official Zapier, Make, and n8n integrations that wire the catalog into your image-processing workflow. If you'd like to be notified when those go live, email hello@imgsize.cc.