This endpoint allows you to get the latest various embed codes in our platform

Collection /Embed

Get HTML embed codes for features in our platform

GET /embed/:id/:type

Get the embed code for a video or playlist

  • id - video or playlist id
  • type - embed type - js (default) or iframe
  • width - width of player (optional)
  • height - height of player (optional)
  • element_id - element_id to add player to (optional) (js type only)
  • token - the security token for the video (optional) (js type only)
  • referrer_url - the referrer URL to use instead of the current page
    (optional) (js type only)
  • player - forces the use of a specific Buto player: akita, poodle or pug
    (optional) (js type only)
  • show_presentation - true if presenter slides should be shown (optional) (js
    type only)

item value
Access user | system | guest
Full url https://api.buto.tv/v2/embed/{id}/{type}
verb GET
params string:id string:type

Example usage

#get javascript-based embed code
curl  --include https://api.buto.tv/v2/embed/12345

returns

HTTP/1.1 200 OK
Content-Type: application/json
...

["

<

div id=\"buto_12345\"><\/div><script>(function(d,config){var script=d.createElement(\"script\");script.setAttribute(\"async\",true);var data=JSON.stringify(config);script.src=\"\/\/js.buto.tv\/video\/\"+data;var s=d.getElementsByTagName(\"script\")[0];s.parentNode.insertBefore(script,s)})(document,{\"object_id\":\"12345\",\"width\":\"640px\",\"height\":\"360px\"})<\/script>"]
#get iFrame based embed code
curl  --include https://api.buto.tv/v2/embed/12345/iframe

returns

HTTP/1.1 200 OK
Content-Type: application/json
...

["

<

iframe id=\"buto_iframe_12345\" src=\"https:\/\/embed.buto.tv\/12345\" width=\"640px\" height=\"360px\" frameborder=\"0\" scrolling=\"no\" allowfullscreen=\"true\"><\/iframe>"]

Example usage with optional params

#get standard 
curl --include https://api.buto.tv/v2/embed/12345/js?width=500px&height=400px&element_id=page_id

returns

HTTP/1.1 200 OK
...
Content-Type: application/json

['

']

GET /embed/presentation/:id

Get the presentation embed for a video as a JsonP string which will embed a video with it's related presenter view

  • video_id - video_id of the video

item value
Access user | system | guest
Full url https://api.buto.tv/v2/embed/presentation/{video_id}
verb GET
params string:video_id

Example usage

#get standard 
curl --include https://api.buto.tv/v2/embed/presentation/12345

returns

HTTP/1.1 200 OK
...
Content-Type: application/json

["

<

div id='buto_12345'><\/div> <script> (function(d, conf) { var b = d.createElement('script'); b.setAttribute('async', true); b.src = '\/\/embed.buto.tv\/presentation\/' + conf.object_id; if (b.addEventListener) { b.addEventListener('load', function() {if (window.ButoAdapters) window.ButoAdapters[conf.object_id].init(conf);}, false); } else if (b.readyState) { b.onreadystatechange = function() {if (window.ButoAdapters) window.ButoAdapters[conf.object_id].init(conf);}; } var s = d.getElementsByTagName('script')[0]; s.parentNode.insertBefore(b, s); })(document, {object_id: '12345', element_id: 'buto_12345', delivery: 'html5'}); <\/script>"]