/iframely

oEmbed proxy. Supports over 1800 domains via custom parsers, oEmbed, Twitter Cards and Open Graph
  1. JavaScript 96.5%
  2. HTML 3.4%
  3. Shell 0.1%
JavaScript HTML Shell
Find file
Latest commit 2844d61 Dec 15, 2016 @nleush nleush Merge branch 'release/1.0.1'
Permalink
Failed to load latest commit information.
docker Add Dockerfile and an init script for container Apr 2, 2016
docs docs: update titles to match prod Nov 16, 2016
lib [whitelist] do not log base domain url Dec 13, 2016
modules [api] do not proxy 500 error from requested page Oct 25, 2016
plugins [domains] yandex maps Dec 15, 2016
static [utils] minimize iframe embed code Sep 29, 2016
test fix main test Dec 12, 2016
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] disable node 0.8 testing Mar 3, 2015
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 v1.0.1 Dec 15, 2016
app.js Add ability to specify custom plugins Oct 28, 2016
cluster.js [server] use 'graceful-cluster' lib Jul 25, 2016
config.js [domains] streamable.com autoplay playerjs Dec 8, 2016
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 to 1.0.1 Dec 15, 2016
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.