API REST Method: video

Get the known information about a Magma video by the Magma video id. You can optionally get known video information of a video within a channel, including the channel's customized video title, description, and tags.

URL
    http://mag.ma/video.format

    http://mag.ma/:id.format

    http://mag.ma/:channel_id/:id.format

Formats
    XML, RSS, JSON, YAML, HTML, text

HTTP Method
    GET

Authentication
    none

Rate Limited
    none

Parameters
    (Either id or URL must be specified.)

  • id. Required. : Magma video identification number.
  • channel_id. Optional. Specify video inside a channel by the channel name.
    • If a video is not inside the specified channel, Magma will send redirect headers to the video URL inside the original poster's channel.
    • Example: http://mag.ma/greg/420278
  • callback. Optional. Specify a function callback (JSON format only)

Response

   XML Example:

              <?xml version="1.0" encoding="UTF-8"?>
              <video>
                <created_at type="datetime">2010-02-26T19:00:07Z</created_at>
                <description>In February, the world's top curators and critics nominated the 100 best 
                design of 2009. Three projects by FAT Lab fellows were in the hunt... but only one can 
                win. But anyway, it will probably be that dead fashion designer... Free Art and 
                Technology Lab: playing above our heads since 2007.</description>
                <embed>
                    &lt;object width=&quot;400&quot; height=&quot;225&quot;&gt;
              
                      &lt;param name=&quot;allowfullscreen&quot; value=&quot;true&quot; /&gt;
                      &lt;param name=&quot;allowscriptaccess&quot; value=&quot;always&quot; /&gt;
              
                      &lt;param name=&quot;movie&quot; value=&quot;http://vimeo.com
                      /moogaloop.swf?clip_id=9749744&amp;amp;show_title=0&amp;amp;
                      show_portrait=0&amp;amp;color=&amp;amp;fullscreen=1&quot; /&gt;
                      &lt;embed src=&quot;http://vimeo.com/moogaloop.swf?clip_id=9749744
                      &amp;amp;show_title=0&amp;amp;show_portrait=0&amp;amp;color=
                      &amp;amp;fullscreen=1&quot; type=&quot;application/x-shockwave-flash&quot; 
                      allowfullscreen=&quot;true&quot; allowscriptaccess=&quot;always&quot;
                      width=&quot;400&quot; height=&quot;225&quot;&gt;&lt;/embed&gt;
              
                    &lt;/object&gt;
                    </embed>
                <id type="integer">420278</id>
                <nsfw type="boolean">false</nsfw>
                <score type="float">5.1</score>
                <source>vimeo</source>
              
                <thumbnail>http://ts.vimeo.com.s3.amazonaws.com/492/116/49211644_200.jpg</thumbnail>
                <title>2009: Year of the FAT</title>
                <updated_at type="datetime">2010-03-13T00:19:30Z</updated_at>
                <canonical_url>http://mag.ma/jamiew/420278</canonical_url>
                <in_channel_url>http://mag.ma/greg/420278</in_channel_url>
                <views_count type="integer">667</views_count>
              
                <comments_count type="integer">2</comments_count>
                <likes_count type="integer">0</likes_count>
                <links_count type="integer">0</links_count>
                <tags_list nil="true"></tags_list>
                <categories_list nil="true"></categories_list>
                <source_url>http://vimeo.com/9749744</source_url>
              </video>

Example Usage

    cURL request using Magma video id:
        curl http://mag.ma/video.xml?id=420278 

    cURL request using Magma video id path:
        curl http://mag.ma/420278.xml 

    cURL request using Magma video id inside a channel:
        curl http://mag.ma/greg/420278.xml 

 

Return to API Documentation