/1/oembedAsk AIget https://api.embedly.com/1/oembedoEmbed is Embedly’s basic offering, providing a simple API for embedding content from any URL. This method follows the oEmbed standard.Query ParamsurlstringThe URL is to retrieve embedding information. This URL must be escaped to ensure that Embedly retrieves the correct link. For example, this Embedly URL.urlsstringA comma separated list of urls for Embedly to process. Each URL must be escaped, but commas separating URLS must NOT be URL encoded. urls accepts a maximum of 10 urls at a time. Embedly processes these urls in parallel, therefore, it’s quicker to use urls for batched processing.maxwidthint32This is the maximum width of the embed in pixels. maxwidth is used for scaling down embeds so they fit into a certain width. If the container for an embed is 500px you should pass maxwidth=500 in the query parameters.maxheightint32This is the maximum height of the embed in pixels. Functions the same as maxwidth, but for the height of the embed instead. It’s noteworthy that maxwidth is preferred over maxheight.widthint32Will 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.heightint32Will scale embeds type rich and video to the exact height that a developer specifies in pixels. Embeds smaller than this height will be scaled up and embeds larger than this height will be scaled down. Note that using this may cause distortion when scaling up embeds.formatstringThe response format – Accepted values: (xml, json)wmodestringWill append the wmode value to the flash object. Possible values include window, opaque and transparent.callbackstringReturns a (jsonp) response format. The callback is the name of the javascript function to execute.allowscriptsbooleanBy 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. Use with care, and this option is only valid when a callback is supplied, otherwise, it is ignored.autoplaybooleanThis will tell the video/rich media to automatically play when the media is loaded. Accepted values: (true, false) Default: falsewordsstringDefaults to 50The words parameter works by trying to split the description at the closest sentence to that word countcharsstringchars is much simpler than words. Embedly will blindly truncate a description to the number of characters you specify adding ... at the end when needed.luxebooleanDefaults to falseWith luxe Embedly’s iframe is initially loaded with poster image and play button rather than loading the whole embed. When the user clicks play the embed is loaded and starts playing.securebooleansecure allows you to serve embeds with a SSL connection. You can also serve images over SSL with our Display product. You can enable this by adding secure=true.schemestringscheme allows to set the protocol scheme explicity to http or https. By default embeds are sent back protocol-less so that they will work in any page. You can explicity set a protocol by adding scheme=https.titlestringWith title Embedly will set the title response attribute to the open_graph, meta, or twitter title if available in the page. Accepted values: (og, twitter, meta)descriptionstringWith description Embedly will set the description response attribute to the open_graph, meta, or twitter description if available in the page. Accepted values: (og, twitter, meta)meta_imagesbooleanDefaults to falseWill return only an image found in meta tags or an API response if set.abooleanDefaults to falseTurns on/off player analyticsdntbooleanDefaults to falseTurns on/off Do Not Track support within embedResponses 200200 400400Updated 11 months ago
