For developers
La API de imgsize.cc
Un catálogo público, pequeño, gratuito y sin autenticación de cada preset de plataforma en imgsize.cc: las dimensiones exactas en píxeles, la relación de aspecto, el tamaño máximo de archivo, los formatos compatibles y el requisito de fondo para Amazon Main Image, Instagram Reel, YouTube Thumbnail, LinkedIn Cover y más de 80 más.
1. Catálogo completo de presets
Devuelve todos los presets en una llamada. Úsalo cuando necesites descubrir qué soporta imgsize.cc.
GET /api/presets.json public · cache 1h 2. Detalle de un preset
Devuelve el registro completo del preset, incluyendo la descripción SEO larga y las reglas de fondo según la plataforma.
GET /api/preset/{slug}.json public · cache 1h 3. Forma de la respuesta
Cada preset en /api/presets.json incluye estos campos:
| 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)" |
Patrones de integración
Sin autenticación, sin límite de velocidad, CORS abierto. Solo un catálogo estático.
- Sin autenticación, sin límite de velocidad. Es un catálogo estático. Haz caché en tu lado por 24 horas; actualiza cuando lo necesites.
- CORS abierto. Cada endpoint sirve Access-Control-Allow-Origin: *, así que puedes obtenerlos desde scripts del navegador.
- Sin API de procesamiento de imágenes. imgsize.cc hace el trabajo de imágenes en el navegador mediante la Canvas API; no exponemos un endpoint de redimensionado alojado. El catálogo le dice a tu código a qué redimensionar; el redimensionado real ocurre del lado del cliente o en tu propio backend.
- Nombres slug estables. Los slugs tienen versión — una vez publicado un slug, no lo renombramos. Agregaremos nuevos presets con nuevos slugs.
- Usa la página SEO para prosa. Si necesitas una descripción legible, enlaza a /presets/{slug} en lugar de embeber nuestro texto.
Integraciones sin código
Próximamente: integraciones oficiales de Zapier, Make y n8n que conectan el catálogo con tu flujo de procesamiento de imágenes. hello@imgsize.cc.