v1

latestOpenAPI 3.1.02026-07-247011.9 KB

/1/display/resize

Resize images to a specified width or height. Aspect ratio will always be preserved, so you shouldn’t expect to receive an image with the exact specified dimensions. If width and height are omitted, then the image will simply be proxied.

get/1/display/resize

Query parameters

urlstring required

The URL of the image to proxy. The URL must be url-encoded to ensure that Embedly retrieves the correct link.

keystring required

Your Embedly API key.

errorurlstring

The URL of the fall back image to use when url fails. The URL must be url-encoded to ensure that Embedly retrieves the correct link.

widthinteger

Maximum width in pixels

heightinteger

Maximum height in pixels

growboolean

Allow upscaling if the image is smaller than the target dimensions.

animateboolean

Setting animate to false will convert the image to the first frame of animation for animated images. Setting this value on non-animated images will have non effect and is safe to do.

compresspngboolean

Setting to true utilizes palette quantization, and increases response time. Setting to false is lossless, zlib compression

qualityinteger

Output quality for JPEG/WebP (1-100). Higher = better quality, larger file.

Response

200