Player Events API & Playback Sync

Iframely iFrames give you an option to control embedded video playback as well as observing events fired by the players. For example you may listen to the event when a video is paused or start the video playback using a custom button.

For it, Iframely can add JavaScript connectors for number of video publishers, unifying their various APIs into a single event model.

Supported publishers

Iframely recognizes YouTube, Vimeo, SoundCloud, Streamable,, Facebook videos, Wistia, Coub, all MP4 videos (+ friendly gifs), Office Mix, sendvid, playstv.

We constantly monitor, discover and add new publishers that can fit into unified events API.

Player API

Iframely events API follows Player.js spec, published under Creative Commons by our colleagues from Embedly.

  • Add &playerjs=true to your API calls to get Iframely iFrames with unified player API. It works when Iframely iFrame is returned.
  • You can use player.js library to manipulate with players. Get it on GitHub.
  • If you use Iframely JSON as your API format, check rel array attribute. We add playerjs value there if we could make player be compatible.

Playback Sync

The most common use case for player events is to synchronize playback accross multiple videos on your site. So that when user clicks to play a new video - the one that is already playing will stop automatically.

Iframely covers this feature without the need to handle events on your side. Simply activate it in your player settings, and Iframely will let only one video play at a time (among players that we can control).


Here's the playback sync example. Try starting a video, and then another. It works across multiple tabs too.