Building Magnify Embeddable Players Using the URL API
The Magnify platform offers an intuitive way to build Single-View and Multi-View embeddable
players simply by constructing URLs based on the video permalinks on your video site.
Getting a basic Single-View player from a URL
If you have the URL for a video player page on your video site, it's easy to get an embeddable
player for that video. Just add “/player/svp” to the end of your video player page URL.
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL: http://runway.magnify.net/video/Brizo/player/svp
Getting a basic Multi-View player from a URL
In order to create a Multi-View player, add “/player/mvp” to the end of your video player page
URL.
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL: http://runway.magnify.net/video/Brizo/player/mvp
Getting a basic Chromeless player from a URL
In order to create a Multi-View player, add “/player/cvp” to the end of your video player page
URL.
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL: http://runway.magnify.net/video/Brizo/player/cvp
1
Loading a specific playlist into a Multi-View Player
If no playlist is specified when building a Multi-View player, the player loads a list of built-in
playlists (“Recently Posted”, “Highest Rated”, “Most Viewed This Week”, “Most Discussed”).
If you would like to load a specific playlist, load a list of playlists or build a list of videos on-thefly from search results you can follow the following examples:
1. Loading a single playlist using the playlist permalink
You can load a single playlist into a Multi-View player by starting with the player page
URL, appending the playlist permalink, and then requesting a Multi-View player embed
using the example above
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo;recent/player/mvp
2. Loading a list of playlists using playlist CIDs
A list of several playlists can be loaded into a Multi-View player by passing in a list of
playlist CIDs separated by spaces. Playlist CIDs can be found using our playlist
search API.
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/mvp/playlist/9R9D850LXG3HSZL3
S9MFNS04JYLYB9C7
3. Loading a list of videos from search results
You can populate a “playlist” of videos for a Multi-View player on-the-fly by passing in a
search command in place of a playlist
Example:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/mvp/playlist/search:fashion
2
Configuring Additional Player Features
The Magnify embeddable players support a range of a additional features that are not
activated by default, but can be turned on when requesting an embeddable player using the
URL API.
Any of these features can be triggered by simply appending their name and the desired
configuration value to the player request URL, separated by slashes (“/”).
Example, Using the compact Single View Player layout:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/svp/layout/compact
Example, Using the built-in “Blue” skin
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/svp/template/blue
Example, Activating a Leave Behind:
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL: http://runway.magnify.net/video/Brizo/player/svp/lb/1
Example, Removing the Companion Ad Overlay from a Single View Player
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/svp/companion/0
Example, Removing the Companion Ad Overlay and the Bottom Banner Ad from
a Multi View Player
Player Page URL: http://runway.magnify.net/video/Brizo
Embeddable Player URL:
http://runway.magnify.net/video/Brizo/player/mvp/companion/0/bottom/0
3
Table of Feature Names and Values
Description
Name
Values
Default Value
Player width (optional, the
player will size to the
width and height of the
window in which it is
loaded)
width
An integer
Window width
Player height (optional,
the player will size to the
width and height of the
window in which it is
loaded)
height
An integer
Window height
Player layout
layout
compact, viral,
thumbnails, empty
string
empty string
(leaving this
value off will
default to the
original player
layout)
Player skin
template
A template CID
The value
selected in the
global player
configuration.
Start autoplaying on load
init_autoplay
0, 1
0
Remove the ability to grab
an embed code
embed_hidden
0, 1
0
Remove the tabs bar
no_tabs
0, 1
0
Mute video (Magnify
hosted videos only)
mute
0, 1
0
Multi View Player only.
Show or hide a bottom
banner ad
bottom
0, 1
1
Show or hide the
companion ad overlay.
Default layout only.
companion
0, 1
1
4
Description
Name
Values
Default Value
Show or hide companion
ad overlay only when the
video plays. Do not show
on player load. Default
layout only.
sync_ad
0, 1
0
Thumbnail widget only.
Show or hide manual
controls.
manual_controls
0, 1
0
Show or hide the title bar.
title_height
An integer.
31
Load a leave behind with
related video, default is
Most Recent Videos
lb
0, 1
0
Load a specific playlist
into the leave behind
panel, separate from a
playlist loaded into the
Multi-View Player
lb_playlist
A playlist CID
recent
Configure the leave
behind countdown
lb_counter
Any positive number
sets the countdown time
to that number of
seconds, 0 will skip the
leave behind entirely
and move onto the next
video immediately, -1
will disable the counter
and the player will not
auto-advance to the
next video
10
Viral layout only. Show
the video description
below the player.
show_description
0, 1
0
Hide the playlist panel in
the Multi-View player
hp
0,1
0
5
Description
Name
Values
Default Value
Show a “read more” link
for the video, if feature is
activated for your channel
and one is configured for
the video.
read_more
0, 1
0
Thumbnail widget only.
Choose where thumbnail
links open.
link_target
_blank, _top
_blank
6