What URLs to send to API?

Iframely suggests your a unique and flexible approach in determining which providers you'd like to support. Instead of white-listing individual providers on your side, we recommend that you choose what types of embeds and widgets work for your app.

Should API usage be a concern, you can opt to skip URLs if Iframely couldn't find embeds that meets your criteria. You'll get result code 417 in such cases. And any 4xx responses don't count towards usage.

There are also legal considerations to be made before sending URLs to Iframely - please see the last section of this guide.

URLs supported by Iframely

Consider this:

  • Iframely knows rich media from over 1900 providers.
  • Add thousands of custom white-label domains by hosters. Say, Brightсove, Bandcamp, Tumblr, Behance, 23video, Libsyn, Podbean, Art19, Droplr and many others.
  • Add thousands domains that use known media players such as YouTube, Vimeo, Ooyala, Wistia, Brightcove, Kaltura, Dailymotion, JWPlayer, Ooyala, etc.
  • Plus entire media networks of USA Today, CNE, NBC local sites and others.
  • Add distributed platforms such as Peertube and Mastodon.
  • Add nearly every news, media and blogging site that we provide summary cards for. Or URL data for your own URL previews.
  • Add any direct link to an image, MP4 videos or PDF files Iframely recognizes and provides embed codes for. Plus GIFs, of course.
  • Plus numerous URL shorteners and URL redirects that mask the original URL.

With this in mind, giving you a definite list of providers is quite a challenge. We simply gave up trying and stopped counting.

We recommend you send us all /^https?:\/\//i links you've got and we'll give you the results, if any.

If you absolutely need one, here's the ever-changing list of 1900+ domains we have in our whitelist: http://iframe.ly/domains.json.

Alternatively, you can always have your internal whitelist of the domains that you want to send to us. If you'd like to block some domains, there's a simple black-listing option in your settings.

White-list widget types

Iframely gives you more granular control and information about rich media types and general URLs data.

In your API settings, please choose rich media types that work for your product. You do it via functional use cases, or rel in terms of Iframely API format.

For example, if you have a chat app, you may wish to disable all of readers such as GitHub Gists and app such as Twitter status embeds (or show them in a popup dialog). Or just leave players only, and get our summary card for other URLs. Or disable our summary card and unfurl URLs yourself.

Also, if you like, API can respond with error 417 ("expectation failed") if no HTML embed codes could be generated according to your settings. This way, such URLs won't affect our billing and be ignored if you don't need to generate previews for those yourself using raw meta data.

Or use your own provider lists

Alternatively, you may opt to use your own white- or black-list of providers.

For blacklist, you can simply head to provider settings and add any domains that Iframely should ignore. We'll respond with error 417, no matter the URL redirects.

For your own whitelist, you'd need to keep it on your servers. If the URL doesn't match your white-listed expression, simply add &media=0 to the API call, and Iframely will disable the media for that individual URL (perhaps, falling back to summary card if allowed).

Before you send a URL to us

Before you send us a URL, we'd like to remind you that there are legal implications of doing so.

According to our Terms of Use, Iframely is only a technical intermediary. Whereby, you are responsible for adhering to the terms of service for each provider.

For your convenience and quick reference, here are the links to the terms of use of our most popular rich media providers: YouTube, Twitter, Facebook and Instagram.

Each provider will also have their own Privacy Policy. Here's Iframely's own policy as well as GDPR considerations.

Please use providers black- or whitelist described above to control which third party Terms of Use you bind yourself too.

Previous article: Bring your own CDN
Next article: AMP format