oEmbed proxy. Supports over 1800 domains via custom parsers, oEmbed, Twitter Cards and Open Graph
JavaScript HTML Shell
Permalink
Failed to load latest commit information.
docker Add Dockerfile and an init script for container Apr 2, 2016
docs [meta] unify oembed product currency_code to currency Jan 3, 2017
lib [core] fix redirect to array of values Mar 1, 2017
modules [tester] bugfix Dec 22, 2016
plugins domains: fix typo on 23video hosted Mar 1, 2017
static [utils] minimize iframe embed code Sep 29, 2016
test fix test Jan 12, 2017
views [debug] move underscore lib to statics Nov 11, 2015
whitelist Whitelist is available to everyone. Happy 2015! Dec 29, 2014
.dockerignore Add Dockerfile and an init script for container Apr 2, 2016
.gitignore gitignore Jan 23, 2014
.travis.yml [tests] remove old unsupported node versions Feb 23, 2017
Dockerfile Add Dockerfile and an init script for container Apr 2, 2016
LICENSE Update readme and license with up-to-date year Jan 13, 2015
README.md Like so? Jun 24, 2016
WHATSNEW.md what's new for v 1.0.3 Feb 28, 2017
app.js app: add a few missing result code messages Jan 10, 2017
cluster.js [server] use 'graceful-cluster' lib Jul 25, 2016
config.js general: handle react apps with fallback to FB user agent Jan 24, 2017
config.local.js.SAMPLE Add ability to specify custom plugins Oct 28, 2016
config.test.js [tests] add end to end tests Oct 14, 2016
config.test_with_custom_plugins.js Add ability to specify custom plugins Oct 28, 2016
logging.js [logging] log sender ip address Mar 29, 2016
package.json update version to 1.0.3 Mar 1, 2017
pm2.json [cluster] update pm2 config Jul 21, 2016
restart-cluster.sh [cluster] add restart script Jul 21, 2016
server.js [server] bugfix module import Nov 22, 2016
test-plugins.sh Make Debug and Tests UI modules a little nicer Oct 25, 2013
utils.js [api] support oembed xml error response Oct 25, 2016

README.md

Iframely API for Responsive Web Embeds

Iframely is fast and simple HTTP API for responsive web embeds and semantic meta. The API covers well over 1800 domains through 200 custom domain plugins and generic parsers for oEmbed, Open Graph and Twitter Cards, powered by Iframely's whitelist.

The whitelist file is pulled from iframely.com and is updated automatically. You can also have your own whitelist file. The whitelisting is manual process, and we do every-day manual regression testing to ensure integrity. Submit your domain, if you publish embeds.

HTTP API are available as oEmbed or Iframely API formats. To make it simple to understand, Iframely format mimics the <head> section of the page with its meta and links elements.

In response to url request, APIs returns you the embeds and meta for a requested web page. Below are data samples from hosted API, just to show you the format:

Iframely can also be used as Node.js library.

Requires Node version 0.10.22 and up.

Get started:

To get started with the APIs:

Contribute

We put our best effort to maintain Iframely and all its domain parsers. Please, feel free to reach us on Twitter or to submit an issue if you have any suggestions. Our support email is support at iframely.com

Fork and pull-request, if you'd like to add more plugins and/or contribute fixes or improvements. By doing so, you make your work available under the same MIT license.

If you see an error in our domains whitelist (you can debug URLs here), please ping us and we'll fix it in no time.

License & Authors

MIT License. (c) 2012-2016 Itteco Software Corp. Nazar Leush, Ivan Paramonau

Please, check the contributors list to get to know awesome folks that also helped a lot.