/1/display/crop

get

https://i.embed.ly/1/display/crop

Crop an image to fill the given dimensions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Crop an image to fill the given dimensions. The image will first be resized to it’s smallest possible size that will fill the entire given dimensions, preserving it’s aspect ratio. The image is then centered within the given dimensions, and any part of the image that doesn’t fit is removed. The same amount is trimmed from each side of the image in the cropping dimension.

Query Params

url

string

required

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

key

string

required

Your Embedly API key.

width

int32

required

The width that the image should fill.

height

int32

required

The height that the image should fill.

errorurl

string

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.

grow

boolean

Defaults to false

Set to true if growing the image is allowed. Otherwise the image will never expand beyond it’s original dimensions, making width and height behave like max width and max height.

animate

boolean

Defaults to true

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.

compresspng

boolean

Defaults to true

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

quality

int32

Defaults to 85

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

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Unauthorized

200200

400400