https://image.snappy.com. You can request resized, padded, or format-converted versions of any product image by appending query parameters to the image URL.
No API key is required to load these URLs - they are public CDN links suitable for use directly in <img> tags or your mobile app.
Getting the image URL
Every product and variant in the Snappy catalog includes image metadata.V3 products
V3 returns images in themedia array on products and variants. Each entry includes a src URL that already points at the image CDN:
src value from the API as-is, or add query parameters to match the size and format your UI needs.
URL format
Query parameters
background is only applied when both width and height are provided. In all other cases it is ignored.Allowed sizes (snapping)
You can pass any positive integer forwidth and height. The CDN snaps your value to the allowed size before serving the image:
100, 200, 300, 400, 500, 600, 800, 1000
For example, width=99 is served as 100, and width=350 is served as 400. This keeps cache efficiency high across all integrations using the same CDN.
If no transformation parameters are provided, the original image is returned unchanged.
How transformations work
Both width and height provided - pad to fit
When both dimensions are given, the image is padded (not cropped, not stretched) to fit the requested box. The original aspect ratio is preserved and empty space is filled with the background color.
This is the recommended mode for product cards and grids where the full product must remain visible.
Only width or height provided - scale preserving ratio
When only one dimension is given, the image is scaled proportionally. The other dimension adjusts automatically. No padding, no cropping.
Neither provided - format only
When no dimensions are given, only format conversion is applied (ifformat is set).
Examples
Recommended sizes by use case
Pick the size closest to your layout need - the snapping behavior ensures you land on one of these values automatically.
Best practices
- Use the first
mediaimage as the card thumbnail when rendering product lists. - Prefer
format=webporformat=autofor web UIs to reduce payload size. - Use both
widthandheightwithbackgroundwhen you need a consistent square or fixed-aspect container without cropping the product. - Reuse the same URL across your app for the same size - identical URLs are served from CDN cache.