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%2Faaronparecki.com%2Farticles%2F2015%2F01%2F04%2F1%2Fowning-my-data-in-2014&maxwidth=500
type
link
url
https://aaronparecki.com/2015/01/04/9/owning-my-data-in-2014
provider_url
https://aaronparecki.com
provider_name
Aaron Parecki
title
Owning My Data in 2014
description
The core principle of the IndieWeb is to own your data by creating content on your own domain with permalinks you control, rather than creating content in silos.
width
height
thumbnail_url
https://aaronparecki.com/2015/01/04/9/dora.jpg
thumbnail_width
771
thumbnail_height
601
author_name
author_url
html
  1.  
  2. {
  3.     "provider_url": "https://aaronparecki.com", 
  4.     "description": "The core principle of the IndieWeb is to own your data by creating content on your own domain with permalinks you control, rather than creating content in silos.", 
  5.     "title": "Owning My Data in 2014", 
  6.     "url": "https://aaronparecki.com/2015/01/04/9/owning-my-data-in-2014", 
  7.     "thumbnail_width": 771, 
  8.     "thumbnail_url": "https://aaronparecki.com/2015/01/04/9/dora.jpg", 
  9.     "version": "1.0", 
  10.     "provider_name": "Aaron Parecki", 
  11.     "type": "link", 
  12.     "thumbnail_height": 601
  13. }
  14.  
  1.  
  2. {
  3.     "provider_url": "https://aaronparecki.com", 
  4.     "description": "The core principle of the IndieWeb is to own your data by creating content on your own domain with permalinks you control, rather than creating content in silos.", 
  5.     "title": "Owning My Data in 2014", 
  6.     "url": "https://aaronparecki.com/2015/01/04/9/owning-my-data-in-2014", 
  7.     "thumbnail_width": 771, 
  8.     "thumbnail_url": "https://aaronparecki.com/2015/01/04/9/dora.jpg", 
  9.     "version": "1.0", 
  10.     "provider_name": "Aaron Parecki", 
  11.     "type": "link", 
  12.     "thumbnail_height": 601
  13. }
  14.