Additional API parameters

In addition to your API settings, you can change what you get as API response for each API request or many of the individual publishers. If not given with an API call, your defaults will be used. If you haven't set up and saved your preferences at least once, the default cloud-wide settings will be used.

For individual API calls


api_key and url are required parameters. If you'd like to secure your API key in your JavaScript code, you can use key parameter, which should be equal to MD5 hash of your actual API key. See how to secure your API key.

You may add the following optional values as query-string parameters with your HTTP requests.

iFrame features:

iframe=1 Explicitely activates Smart iFrames. Embed will be wrapped into Iframely iFrame or a URLs preview will be generated as a Summary Card
iframe=amp Formats HTML code output for Accelerated Mobile Pages framework
omit_script=1 Excludes embed.js from HTML codes, if you load it yourself. It also forces script-based embeds be returned as <iframe> instead (useful e.g. for React.js)
omit_css=1 Formats HTML with CSS classnames instead of inline styles. Lets you fine-tune embed codes via CSS. Makes Twitter and Facebook not cause flicks on the page.
align=left Skips default center aligning of Twitter, Facebook, Instagram and other app embeds
playerjs=1 Activates Player.js events to control players where possible. Requires iFrame.
lazy=1 Activates lazy-loading when Iframely returns a smart iFrame

Content filters:

ssl=1 Returns only embeds that can be used under HTTPs without active SSL mixed-content warnings (images and mp4 videos trigger only passive warnings and thus will pass this check)
html5=1 Returns only embeds that can be viewed on mobile devices or desktops without Flash plugin installed
media=1 "Prefer media-only". For some publishers, Iframely knows status-like app embeds AND simple media, such as photos or video. This option will make Iframely return actual media in the html field instead of branded embeds. It affects, for example, Instagram, Tumblr, Imgur, Pinterest (for videos), etc.
autoplay=1 Gives preference to autoplay media and will try to return it as primary html. Check for autoplay in primary rel to verify. Available only with Iframely API endpoint.
maxwidth= In pixels, returns only embeds that do not exceed this width. It affects the rare cases of fixed-width embeds as in most cases Iframely gives the responsive embed codes. It doesn't limit the size of embed because many WordPress sites have this setting wrong (&omit_css instead)


origin= Optional tag text value that will help you later search links in your dashboard. It represents the hashtag E.g. project or chat room name, category, app, if you got several, etc.
callback Name of a JavaScript function, if you’d like response to be wrapped as JSONP
format=xml For oEmbed API only, if you'd like to get your response as XML

For individual embeds publishers

Number of publishers give different embedding options. By default, Iframely provides embeds that we believe is the best fit for most common use case. But you, of course, might want it differently.

Most frequently requested adjustments are available for self-service in your settings. For other cases, Iframely team can configure the exact embeds you like for your favourite publishers. Ask away.

For individual URLs

In addition your default account's settings and parameters, your users may toggle the embedding settings for individual URL to get exact variat they need for their specific post.

It is done by adding Iframely's query-string command direclty inside the URL. Read about "More/Less" toggle and share with your users.