Embedly

Explore Embed

Advanced Options
maxwidth

This is the maximum width of the embed in pixels. maxwidth is used for scaling down embeds so they fit into a certain width.

maxheight

This is the maximum height of the embed in pixels. Functions the same as maxwidth, but for the height of the embed instead.

width

Will scale embeds type rich and video to the exact width that a developer specifies in pixels. Embeds smaller than this width will be scaled up and embeds larger than this width will be scaled down. Note that using this may cause distortion when scaling up embeds.

autoplay

This will tell the video/rich media to automatically play when the media is loaded.

luxe

Embedly's iframe is initially loaded with poster image and play button rather than loading the whole embed. Faster load times with a uniform design. Enable Luxe embeds by setting this value to 1.

words

The words parameter works by trying to split the description at the closest sentence to that word count. Default: 50

chars

Chars is much simpler than words. Embedly will blindly truncate a description to the number of characters you specify adding ... at the end when needed.

videosrc

If true Embedly will use the video_src meta or Open Graph tag to create a video object to embed. While Embedly uses the video_src tag to create embeds for supported providers, it can create unexpected behavior when it’s used in a broader context. Videos will autoplay or may contain malicious content.

allowscripts

By default Embedly does not return script embeds for jsonp requests. They just don’t work and cause lots of issues. In some cases, you may need the script tag for saving and displaying later. In order for Embedly to send the script embeds over jsonp add allowscripts=true.

JSON
Raw
API call http://api.embed.ly/1/oembed?url=http%3A%2F%2Fvimeo.com%2F18150336&maxwidth=500
type
video
url
provider_url
https://vimeo.com/
provider_name
Vimeo
title
Wingsuit Basejumping - The Need 4 Speed: The Art of Flight
description
The Need 4 Speed: The Art of Flight A collection of shots from flights made during the 2009-2010 season by the talented group of wingsuit basejumpers, while flying the V3, Hybrid LD2/Trango rigs and testing several new V-series wingsuit prototypes around Europe. Feel the need. The need for speed!
width
500
height
281
thumbnail_url
https://i.vimeocdn.com/video/117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280
thumbnail_width
1280
thumbnail_height
720
author_name
Phoenix Fly
author_url
https://vimeo.com/phoenixfly
html
<iframe class="embedly-embed" src="//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fplayer.vimeo.com%2Fvideo%2F18150336%3Fapp_id%3D122963&dntp=1&display_name=Vimeo&url=https%3A%2F%2Fvimeo.com%2F18150336&image=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280&type=text%2Fhtml&schema=vimeo" width="500" height="281" scrolling="no" title="Vimeo embed" frameborder="0" allow="autoplay; fullscreen; encrypted-media; picture-in-picture;" allowfullscreen="true"></iframe>
  1.  
  2. {
  3.     "provider_url": "https://vimeo.com/", 
  4.     "description": "The Need 4 Speed: The Art of Flight A collection of shots from flights made during the 2009-2010 season by the talented group of wingsuit basejumpers, while flying the V3, Hybrid LD2/Trango rigs and testing several new V-series wingsuit prototypes around Europe. Feel the need. The need for speed!", 
  5.     "title": "Wingsuit Basejumping - The Need 4 Speed: The Art of Flight", 
  6.     "type": "video", 
  7.     "thumbnail_width": 1280, 
  8.     "height": 281, 
  9.     "width": 500, 
  10.     "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fplayer.vimeo.com%2Fvideo%2F18150336%3Fapp_id%3D122963&dntp=1&display_name=Vimeo&url=https%3A%2F%2Fvimeo.com%2F18150336&image=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280&type=text%2Fhtml&schema=vimeo\" width=\"500\" height=\"281\" scrolling=\"no\" title=\"Vimeo embed\" frameborder=\"0\" allow=\"autoplay; fullscreen; encrypted-media; picture-in-picture;\" allowfullscreen=\"true\"></iframe>", 
  11.     "author_name": "Phoenix Fly", 
  12.     "version": "1.0", 
  13.     "provider_name": "Vimeo", 
  14.     "thumbnail_url": "https://i.vimeocdn.com/video/117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280", 
  15.     "thumbnail_height": 720, 
  16.     "author_url": "https://vimeo.com/phoenixfly"
  17. }
  18.  
  1.  
  2. {
  3.     "provider_url": "https://vimeo.com/", 
  4.     "description": "The Need 4 Speed: The Art of Flight A collection of shots from flights made during the 2009-2010 season by the talented group of wingsuit basejumpers, while flying the V3, Hybrid LD2/Trango rigs and testing several new V-series wingsuit prototypes around Europe. Feel the need. The need for speed!", 
  5.     "title": "Wingsuit Basejumping - The Need 4 Speed: The Art of Flight", 
  6.     "type": "video", 
  7.     "thumbnail_width": 1280, 
  8.     "height": 281, 
  9.     "width": 500, 
  10.     "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fplayer.vimeo.com%2Fvideo%2F18150336%3Fapp_id%3D122963&dntp=1&display_name=Vimeo&url=https%3A%2F%2Fvimeo.com%2F18150336&image=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280&type=text%2Fhtml&schema=vimeo\" width=\"500\" height=\"281\" scrolling=\"no\" title=\"Vimeo embed\" frameborder=\"0\" allow=\"autoplay; fullscreen; encrypted-media; picture-in-picture;\" allowfullscreen=\"true\"></iframe>", 
  11.     "author_name": "Phoenix Fly", 
  12.     "version": "1.0", 
  13.     "provider_name": "Vimeo", 
  14.     "thumbnail_url": "https://i.vimeocdn.com/video/117311910-e0a08be50da3bb6db652e7efe426e86e375b4aee646fd158a33b31081061a330-d_1280", 
  15.     "thumbnail_height": 720, 
  16.     "author_url": "https://vimeo.com/phoenixfly"
  17. }
  18.