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
- 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.
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 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 invidual 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.