/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 5a02742 Sep 29, 2016 @nleush nleush [utils] compact fixed height embed code
Permalink
Failed to load latest commit information.
docker Add Dockerfile and an init script for container Apr 2, 2016
docs [docs] graceful restart info; add pm2 info Jul 21, 2016
lib [utils] compact fixed height embed code Sep 29, 2016
modules [tests] bugfix Sep 7, 2016
plugins [tests] fix tidal.com Sep 27, 2016
static [utils] compact fixed height embed code Sep 29, 2016
test [tests] fix npm test Aug 26, 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 update version to 0.9.9 Sep 27, 2016
cluster.js [server] use 'graceful-cluster' lib Jul 25, 2016
config.js [config] use 'config.local.js' if no 'config.<NODE_ENV>.js' file Sep 12, 2016
config.local.js.SAMPLE [domains] Facebook: config sample to omitscript Jul 4, 2016
logging.js [logging] log sender ip address Mar 29, 2016
package.json update version to 0.9.9 Sep 27, 2016
pm2.json [cluster] update pm2 config Jul 21, 2016
restart-cluster.sh [cluster] add restart script Jul 21, 2016
server.js [server] use CONFIG.ssl to set https server options Aug 18, 2016
test-plugins.sh Make Debug and Tests UI modules a little nicer Oct 25, 2013
utils.js [api] better error nandler Apr 27, 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.