Embedly | Embed any URL through one powerful API

Path

/1/image/fill

Description

Resize and fill in any extra space with a specified color. The image is always centered on the canvas with it's aspect ratio perserved.

Parameters

:key: Your embedly key. You can find your key on http://app.embed.ly, or sign up at http://embed.ly/pricing.
:errorurl: If the target url is not found or can not be proxied for any other reason, this image will be returned instead.
:animate: 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: Will run images through pngcompressor. Increases response time.
:url: The url of the image that we are proxying. Any URL that a browser will recognize should work, but it must be URL encoded.
:quality: Quality of the image between 1 and 95.
:grow: Set to true if growing the image is allowed. Otherwise it will never expand beyond it's original size, making width and height behave like maxwidth and max height.
:color: The css color to fill with. Color should match the regular expression /^#?([0-9a-fA-F]{6}|[0-9a-fA-F]{3})$/.
:width: The width that the image should fill.
:height: The height that the image should fill.

Example

/1/image/fill?

url=http://embed.ly/static/images/squiggle2.png
key=xxxxxx
color=000
width=400
height=400

Path

/1/image/crop

Description

Resize to width and height, cropping any excess image. The image is always centered on the canvas.

Parameters

:key: Your embedly key. You can find your key on http://app.embed.ly, or sign up at http://embed.ly/pricing.
:errorurl: If the target url is not found or can not be proxied for any other reason, this image will be returned instead.
:animate: 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: Will run images through pngcompressor. Increases response time.
:url: The url of the image that we are proxying. Any URL that a browser will recognize should work, but it must be URL encoded.
:quality: Quality of the image between 1 and 95.
:grow: Set to true if growing the image is allowed. Otherwise it will never expand beyond it's original size, making width and height behave like maxwidth and max height.
:width: The width that the image should fill.
:height: The height that the image should fill.

Example

/1/image/crop?

url=http://embed.ly/static/images/squiggle2.png
key=xxxxxx
width=400
height=400

Path

/1/image/resize

Description

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

Parameters

:key: Your embedly key. You can find your key on http://app.embed.ly, or sign up at http://embed.ly/pricing.
:errorurl: If the target url is not found or can not be proxied for any other reason, this image will be returned instead.
:animate: 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: Will run images through pngcompressor. Increases response time.
:url: The url of the image that we are proxying. Any URL that a browser will recognize should work, but it must be URL encoded.
:quality: Quality of the image between 1 and 95.
:grow: Set to true if growing the image is allowed. Otherwise it will never expand beyond it's original size, making width and height behave like maxwidth and max height.
:width: The width that the image should fill.
:height: The height that the image should fill.

Example

/1/image/resize?

url=http://embed.ly/static/images/squiggle2.png
key=xxxxxx
height=400
grow=true

Path

/1/image

Description

Proxy the image.

Parameters

:key: Your embedly key. You can find your key on http://app.embed.ly, or sign up at http://embed.ly/pricing.
:errorurl: If the target url is not found or can not be proxied for any other reason, this image will be returned instead.
:animate: 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: Will run images through pngcompressor. Increases response time.
:url: The url of the image that we are proxying. Any URL that a browser will recognize should work, but it must be URL encoded.

Example

/1/image?

url=http://embed.ly/static/images/squiggle2.png
key=xxxxxx